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getnetent(3n) 

getnetgrent(3n) 

getopt(3) 

hwconf(2) 

kopt(2) 

getpwent(3) 

getcwd(3f) 

getpgrp(2) 

getpid(3f) 

getpid(2) 

times (3 c) 

getsockname(2) 

perror(3f) 

getpagesize(2) 

getttyent(3) 

getuid(2) 

getuid(3f) 

getlog(3f) 

getenv(3f) 

getdirentries(2) 

gettimeofday(2) ^ 

getdomainname(2) I 

gethostname(2) ^-- 

getpriority(2) 

gethostid(2) 

getitimer(2) 
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space, closepl 

sinn, cosh, tanh 

machines rquota 

syscall 

initgroups 

popen, pclose 

socket connect 

queue insque, rem que 

abs 

functions intro 

functions intro 

library functions math 

and error numbers intro 

asinh, acosh, atanh 

system 

filesystems mount 

end, etext, edata 

end, etext, edata 

examples 

data representation xdr 

procedure calls rpc 

socket listen 

lgamma 

mkdir 

link 

link 

mknod 

mktemp 

symlink 

quota 

quotactl 

getenv, setenv, unsetenv 

of a ldlread, ldlinit, ldlitem 

mmap, munmap 

uncacheable cachectl 

free, realloc, calloc, alloca 

memchr, memcmp, memcpy, mem set 

mount 

lseek 

arithmetic 

setjmp, longjmp 

reading ldopen, ldaopen 

writing, or create a new open 

fopen, freopen, fdopen 

ecvt, fcvt, gcvt 

VADS libraries 

monitor, monstartup, moncontrol 

printcap 

ptrace 

assert 

in Ada publiclib 

stream ungetc 

puts, fputs 

putc, putchar, fputc, putw 

qsort 

qsort 

rand, srand 

rand, irand, srand 

getpass 

entry of a common ldtbread 

header of a ldshread, ldnshread 

read, readv 

member of an archive ldahread 

common object file ldfhread 

readlink 

reboot 

recv, recvfrom, recvmsg 

re_comp, re_exec 

rex 

unlink 

rmdir 

unmount 

unlink 

unit fseek, ftell 

fseek, ftell, rewind 

resjnit, dn_comp, dn_expand 



graphics interface plot(3x) 

hyperbolic functions sinh(3m) 

implement quptas on remote rquota(3r) 

indirect system call syscall(2) 

initialize group access list initgroups(3) 

initiate 1,0 to, from a process popen(3) 

initiate a connection on a connect(2) 

insert, remove element from a insque(3) 

integer absolute value abs(3) 

introduction to C library intro(3) 

introduction to FORTRAN library intro(3f) 

introduction to mathematical math(3m) 

introduction to system calls . intro(2) 

inverse hyperbolic functions asinh(3m) 

issue a shell command system(3) 

keep track of remotely mounted mount(3r) 

last locations in program end(3) 

last locations in program . end(3) 

library of sample programs examples(3) 

library routines for external xdr(3n) 

library routines for remote rpc(3n) 

listen for connections on a listen(2) 

log gamma function lgamma(3m) 

make a directory file mkdir(2) 

make a hard link to a file link(2) 

make a link to an existing file link(3f) 

make a special file . mknod(2) 

make a unique file name . . mktemp(3) 

make symbolic link to a file symlink(2) 

manipulate disk quotas . ; quota(2) 

manipulate disk quotas quotactl(2) 

manipulate environmental getenv(3) 

manipulate line number entries ldlread(3x) 

map or unmap pages of memory mmap(2) 

mark pages cacheable or cachectl(2) 

memory allocator malloc, malloc(3) 

memory operations memccpy, memory(3) 

mount file system mount(2) 

move read,write pointer lseek(2) 

multiple precision integer . • mp(3x) 

non-local goto setjmp(3) 

open a common object file for ldopen(3x) 

open a file for reading or open(2) 

open a stream fopen(3s) 

output conversion ecvt(3) 

overview of VADS libraries libraries(3) 

prepare execution profile monitor(3) 

printer capability database printcap(5) 

process trace ptrace(2) 

program verification assert(3) 

public domain packages written publiclib (3) 

push character back into input ungetc(3s) 

put a string on a stream puts(3s) 

put character or word on a putc(3s) 

quick sort qsort(3f) 

quicker sort qsort(3) 

random number generator rand(3c) 

random number generator rand(3f) 

read a password getpass(3) 

read an indexed symbol table ldtbread(3x) 

read an indexednamed section ldshread (3x) 

read input read(2) 

read the archive header of a ldahread(3x) 

read the file header of a ldfhread(3x) 

read value of a symbolic link readlink(2) 

reboot system or halt processor reboot(2) 

receive a message from a socket recv(2) 

regular expression handler regex(3) 

remote execution protocol rex(3r) 

remove a directory entry unlink(3f) 

remove a directory file rmdir(2) 

remove a file system unmount(2) 

remove directory entry unlink (2) 

reposition a file on a logical fseek(3f) 

reposition a stream fseek(3s) 

resolver routines res_send, resolver(3) 
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given an index ldgetaux 

given a procedure ldgetpd 

file Idgetname 

getarg, iargc 

ASCII, string fdate 

numerical form id ate, itime 

etime, dtime 

sigreturn 

on remote rnusers, rusers 

len 

command rexec 

time, ctime, Itime, gmtime 

loc 

to a rcmd, rresvport, ruserok 

read write interface to the stio 

compilation unit symbol stcu 

high-level interface to stfe 

per file descriptor section stfd 

interfaces to auxiliaries staux 

table stprint 

_procedure_string_table 

^procedure^stringjable 

scandir, alphasort 

time alarm 

time ualarm 

"optimal" cursor motion curses 

of a common Idsseek, ldnsseek 

a section of a ldlseek, ldnlseek 

section of a Idrseek, Idnrseek 

header of a common Idohseek 

common object file ldtbseek 

send, sendto, sendmsg 

kill 

kill 

killpg 

(defunct) stty, gtty 

context sigstack 

sigsetmask, sigmask 

umask 

utime 

utimes 

setgroups 

setpgrp 

nice 

setregid 

ID's setreuid 

setruid, setgid, setegid, setrgid 

connection shutdown 

facilities signal 

sigvec 

memory efficient way vfork 

exponent frexp, ldexp, modf 

package stdio 

cshrc 

pause 

f err or, feof, clear err, fileno 

strpbrk, strspn, strcspn, strtok 

graphics terminal lib 2648 

timezone 

interval sleep 

sleep 

usleep 

swab 

state with that on disk fsync 

select 

perror, sys„errlist, sys^nerr 

psignal, sys^siglist 

term cap 

tgetflag, tgetstr, tgoto, tputs 

abort 

^exit 

flushing any pending output exit 

cos, tan, asin, acos, atan, atan2 

length truncate, ftruncate 

acct 

sync 



retrieve an auxiliary entry, . . 
retrieve procedure descriptor 
retrieve symbol name for object 
return command line arguments 
return date and time in an . . 
return date or time in . » . . . 
return elapsed execution time 
return from signal , . . . • 
return information about users 
return length of Fortran string 
return stream to a remote .. . 
return system time ,..',. 
return the address of an object 
routines for returning a stream 
routines that provide a binary 
routines that provide a » . ■, 
routines that provide a ... 
routines that provide access to 
routines that provide scalar 
routines to print the symbol 
runtime procedure table • , , 
runtime procedure table . .. , 
scan a directory ,,..-.. 
schedule signal after specified 
schedule signal after specified 
screen functions with • . . • 
seek to an index ednamed section 
seek to line number entries of 
seek to relocation entries of a 
seek to the optional file . . • 
seek to the symbol table of a 
send a message from a socket 
send a signal to a process , . 
send signal to a process , . » 
send signal to a process group 
set and get terminal state . .. 
set and,or get signal stack . . 
set current signal mask . . . 
set file creation mode mask 
set file times ........ 

set file times ,,,......' 

set group access list • . « , . 
set process group ,'.,,,. 
set program priority , . . , 
set real and effective group ID 
set real and effective user . . 
set user and group ID seteuid, 
shut down part of a full-duplex 
simplified software signal ,. . 
software signal facilities . # . 
spawn new process in a virtual 
split into mantissa and * . » 
standard buffered input,output 
startup file for csh command 
stop until signal . . • , , 
stream status inquiries . , . 
string operations strrchr, , . 
subroutines for the HP £648 
supply timezone string . * . 
suspend execution for an 
suspend execution for interval 
suspend execution for interval 
swap bytes . , f • , . . , . 
synchronize a file's in-core 
synchronous I,Q multiplexing 
system error messages . . . 
system signal messages . . . 
terminal capability data base , 
terminal independent tgetnum, 
terminate Fortran program , 
terminate a process ..... 

terminate a process after . . 
trigonometric functions sin, . 
truncate a file to a specified 
turn accounting on or off . . 
update superr-b lock . ■ .• • . . 



ldgetaux(3x) 

ldgetpd(3x) 

ldgetname(3x) 

getarg(3f) 

fdate(3f) 

idate(3f) 

etime(3f) 

sigreturn (2) 

rnusers(3r) 

len(3f) 

rexec(3) 

time(3f) 

loc(3f) 

rcmd(3) 

stio(3) 

stcu(3) 

stfe(3) 

stfd(3) 

staux(3) 

stprint(3) 

end(3) 

end(3) 

scandir(3) 

alarm (3c) 

ualarm(3) 

curses (3x) 

ldsseek(3x) 

ldlseek(3x) 

ldrseek(3x) 

ldohseek(3x) 

ldtbseek(3x) 

send(2) 

kill(3f) 

kill(2) 

killpg(2) 

stty(3c) 

sigstack(2) 

sigsetmask(2) 

urn ask (2) 

utime(3c) 

utimes(2) 

setgroups(2) 

setpgrp(2) 

nice(3c) 

setregid(2) 

setreuid(2) 

setuid(3) 

shutdown(2) 

signal(3c) 

sigvec(2) 

vfork(2) 

frexp(3) 

stdio(3s) 

cshrc(5) 

pause(3c) 

ferror(3s) 

string(3) 

lib2648(3x) 

timezone(3) 

sleep(3f) 

sleep(3) 

usleep(3) 

swab(3) 

fsync(2) 

select(2) 

perror(3) 

psignal(3) 

term cap (5) 

termcap(Sx) 

abort(3f) 

exit(2) 

exit(3) 

sin(3m) 

truncate(2) 

acct(2) 

sync(£) 
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pages yppasswd 

varargs 

current control terminal vhangup 

terminatesystem(3f) can not wait 

wait, wait3 

logical unit putc, fputc 

write, writev 

machines rwall 

yperr_string, ypprot_err 

super-user( returns 

lib2648 : subroutines for the HP 

tzset : convert date and time to 

: return date and time in an 

atof, atoi, atol : convert 

public domain packages written in 

verdixlib : MIPS -supported 

intro : introduction to 

crypt, setkey, encrypt : 

ether_jiostton, ether_Jine : 

absolute value hypot, cabs : 

intro : introduction to 

abort : terminate 

len : return length of 

lib2648 : subroutines for the 

: set real and effective group 

setrgid : set user and group 

getgid : get user or group 

: set real and effective user 

fp_class : classes of 

fp_class : classes of 

select : synchronous 

popen, pclose : initiate 

inetjinaof, inet_netof : 

emulate_b ranch : 

emulate_b ranch : 

disassembler : disassemble a 

read write interface to the 

packages verdixlib : 

in can not be longer than 

nfssvc, async_daemon : 

ns_addr, ns_ntoa : Xerox 

getrpcbynumber : get 

getrpcport : get 

fp_sigintr : generate a 

system : execute a 

VADS libraries : overview of 

libraries 

standard : 

routines ns_addr, nsjQtoa : 



abs : integer 

: Euclidean distance, complex 

and fabs, floor, ceil, rint : 

socket 

accept : 

of a file 

of a file 

of file 

getgroups : get group 

initgroups : initialize group 

setgroups : set group 

ranhashinit, ranhash, ranlookup : 

stfd : routines that provide 

access : determine 

access : determine 

access : determine 

acct : execution 

acct : turn 



functions sin, cos, tan, asin, 

functions asinh, 

signal : change the 

paging,swapping swapon : 



: update user password in yellow . . yppasswd(3r) 

: variable argument list varargs(3) 

: virtually "hangup" the vhangup(2) 

: wait for a process to f . . . , wait(3f) 

: wait for process to terminate wait(2) 

: write a character to a fortran . . putc(3f) 

: write output write(2) 

: write to specified remote rwall(3r) 

; yellow pages client interface ypclnt(3n) 

:1 if it was not invoked by the initgroups(3) 

2648 graphics terminal Iib2648(3x) 

ASCII gmtime, asctime, timezone, ctime(3) 

ASCH string fdate . . fdate(3f) 

A SCII to numbers atof(3) 

Ada publiclib : . publiclib(3) 

Ada library packages verdixlib(3) 

C library functions . intro(3) 

DES encryption . . crypt(3) 

Ethernet address mapping ethers(3n) 

Euclidean distance, complex . hypot(3m) 

FORTRAN library functions . . intro(3f) 

Fortran program abort(3f) 

Fortran string len(3f) 

HP 2648 graphics terminal Iib2648(3x) 

ID setregid setregid(2) 

ID setruid, setgid, setegid, setuid(3) 

ID of the caller getuid, . getuid(3f) 

ID's setreuid setreuid(2) 

IEEE floating-point values fp_class(3) 

IEEE floating-point values fp_class(3) 

1,0 multiplexing select(2) 

1,0 to,from a process . , poperi(3) 

Internet ineCmakeaddr, inet(3n) • 

MIPS branch emulation . emulated ranch (3) 

MIPS branch emulation emulatej?ranch(3) 

MIPS instruction and print the disassembler(3x) 

MIPS symbol table a binary . . . , . stio(3) 

MEPS-supported Ada library . . verdixlib (3) 

NCARGS:50 characters, as defined wait(3f) 

NFS daemons . nfssvc(2) 

NS(tm) address conversion ns(3n) 

RPC entry getrpebyname, ge^rpcent(3n) 

RPC port number getrpcport(3r) 

SIGFPE signal on floating-point fp_sigintr(2) 

UNIX command system(3f) 

VADS libraries libraries(3) 

VADS libraries : overview of VADS libraries(3) 

VADS standard library standard(3) 

Xerox NS(tm) address conversion ns(3n) 

abort : generate a fault abort(3) 

abort : terminate Fortran program abort(3f) 

abs : integer absolute value abs(3) 

absolute value abs (3) 

absolute value hypot, cabs . hypot(3m) 

absolute value, floor, ceiling, floor(3m) 

accept : accept a connection on a accept(£) 

accept a connection on a socket . , . accept(2) 

access : determine accessibility access(3f) 

access : determine accessibility access(3f) 

access : determine accessibility . access(2) 

access list getgroups(2) 

access list initgroups(3) 

access list setgroups(2) 

access routine for the symbol , ranhash(3x) 

access to per file descriptor stfd(3) 

accessibility of a file access(3f) 

accessibility of a file ...,., access(3f) 

accessibility of file , access(2) 

accounting file acct(5) 

accounting on or off acct(2) 

acct : execution accounting file * acct(5) 

acct : turn accounting on or off acct(2) 

acos, atan, atan2 : trigonometric sin(3m) 

acosh, atanh : inverse hyperbolic asinh(3m) 

action for a signal signal(3f) 

add a swap device for interleaved swapon(2) 
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get file getmntent, setmntent, 

ns_addr, ns__ntoa : Xerox NS(trn) 

references) fixade : fix 

ether_line : Ethernet 

loc : return the 

allow synchronization of the 

flock : apply or remove an 

lockf : 

after a specified time 

specified time 

valloc : 

malloc, free, realloc, calloc, 

realloc, calloc, alloca : memory 

valloc : aligned memory 

calls siginterrupt : 

adjtime : correct the time to 

scandir, 

fpi : floating-point interrupt 

fpi : floating-point interrupt 

: flush contents of instruction 

sigstack : set 

output 

on an open file flock : 

archive header of a member of an 

archive file ldahread : read the 

varargs : variable 

iargc ; return command line 

getopt : get option letter from 

: multiple precision integer 

ctime, localtime, gmtime, 

trigonometric sin, cos, tan, 

hyperbolic functions 

a.out : 

setbuf, setbuffer, setlinebuf : 

nfssvc, 

sin, cos, tan, asin, acos, 

sin, cos, tan, asin, acos, atan, 

functions asinh, acosh, 

to numbers 

numb ers atof , 

atof, atoi, 

signals and wait for sigpause : 

that provide scalar interfaces to 

ldgetaux ; retrieve an 

: terminal capability data 

delete, firstkey, nextkey : data 

dbm„error, dbm_clearerr : data 

provide a high-level interface to 

string operations bcopy, 

byte string operations 

jO, jl, jn, yO, yl, yn : 

srandom, initstate, setstate : 

fread, fwrite ; buffered 

stio ; routines that provide a 

bind : 

bcopy, bcmp, bzero, ffs : 

sigblock : 

sigpause : atomically release 

emulated ranch : MIPS 

emulate_b ranch : MIPS 

size 

fread, fwrjte : 

stdio : standard 

setbuffer, setlinebuf : assign 

values between host and network 

bcopy, bcmp, bzero, ffs : bit and 

swab : swap 

operations bcopy, bcmp, 

complex absolute value hypot, 

of instruction and, or data 

cachectl : mark pages 

or uncacheable 

instruction and, or data cache 

syscall : indirect system 



addmntent, endmntent, hasmntopt 
address conversion routines . 
address exceptions (unaligned 
address mapping operations . 
address of an object • . . . 
adjtime : correct the time to 
advisory lock on an open file 
advisory record locking on files 
alarm : execute a subroutine 
alarm : schedule signal after 
aligned memory allocator . . 
alloca : memory allocator . . 
allocator m alloc, free, . . . 
allocator .,,....,, 

allow signals to interrupt system 
allow synchronization of the 
alphasort : scan a directory 
analysis .......... 

analysis .......... 

and, or data cache cacheflush 
and, or get signal stack context 
a,out : assembler and link editor 
apply or remove an advisory lock 
archive file ldahread : read the 
archive header of a member of an 
argument list ...... 

arguments getarg, , . . . 

argv 

arithmetic ........ 

asctime, timezone, tzset : 
asin, acos, atan, atan2 : 
asinh, acosh, atanh : inverse 
assembler and link editor output 
assert : program verification 
assign buffering to a stream 
async^daemon ; NFS daemons 
atan, atan2 : trigonometric 
atan2 ; trigonometric functions 
atanh : inverse hyperbolic 
atof, atoi, atol : convert ASCII 
atoi, atol : convert ASCII to 
atol : convert ASCII to numbers 
atomically release blocked 
auxiliaries staux : routines 
auxiliary entry, given an index 
base termcap .,.,*.. 
base subroutines fetch, store, 
base subroutines dbm^nextkey, 
basic functions needed that « 
bcmp, bzero, ffs : bit and byte 
bcopy, bcmp, bzero, ffs : bit and 

bessel functions , 

better random number generator; 
binary input ? output .... 
binary read write interface to 
bind : bind a name to a socket 
bind a name to a socket . . 
bit and byte string operations 

block signals , , 

blocked signals and wait for 

branch emulation 

branch emulation ..... 

brk, sbrk ; change data segment 
buffered binary input, output 
buffered input, output package 
buffering to a stream setbuf, 
byte order ntohs : convert 
byte string operations . . . 
bytes ........... 

bzero, ffs : bit and byte string 
cabs : Euclidean distance, 
cache : flush contents . . . 
cacheable or uncacheable . . 
cachectl ; mark pages cacheable 
cacheflush : flush contents of 
can .p.... ...«.• 



getmntent(3) 

ns(3n) 

fixade(2) 

ethers(3n) 

loc(3f) 

adjtime(2) 

flock(2) 

lockf(3) 

alarm (3f) 

alarm (3 c) 

valloc(3c) 

malloc(3) 

malloc(3) 

valloc(3c) 

siginterrupt(3) 

adjtime(2) 

scandir(3) 

fpi(3) 

fpi(3) 

cacheflush(2) 

sigstack(2) 

a.out(4) 

flock(2) 

ldahread(3x) 

ldahread(3x) 

varargs (3) 

getarg(3f) 

getopt(3) 

mp(3x) 

ctime(3) 

sin(3m) 

asinh(3m) 

a.out(4) 

assert(3) 

setbuf(3s) 

nfssvc(2) 

sin(3m) 

sin(3m) 

asinh(3m) 

atof(3) 

atof(3) 

atof(3) 

sigpause(2) 

staux(3) 

ldgetaux(3x) 

termcap(S) 

dbm(3x) 

ndbm(3) 

stfe(3) 

bstring(3) 

bstring(3) 

j0(3m) 

random (3) 

fread(3s) 

stio(3) 

bind(2) 

bind(2) 

bstring(3) 

sigblock(2) 

sigpause(2) 

emulate3ranch(3) 

em ulate_branch(3) 

brk(2) 

fread(3s) 

stdio(3s) 

setbuf(3s) 

byteorder(3n) 

bstring(3) 

swab(3) 

bstring(3) 

hypot(3m) 

cacheflush(2) 

cachectl(2) 

cachectl(2) 

cacheflush(2) 

syscall(2) 
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: get user or group ID of the 

malloc, free, realloc, 

routines for remote procedure 

allow signals to interrupt system 

intro : introduction to system 

term cap : terminal 

printcap : printer 

root 

floor, ceiling, and fabs, floor, 

rint : absolute value, floor, 

chdir : 

brk, sbrk : 

chdir : 

chmod : 

chown : 

signal : 

rename : 

an interprocess communication 

ungetc : push 

toupper, tolower, toascii : 

getc, fgetc : get a 

getc, getchar, fgetc, getw : get 

putc, putchar, fputc, putw : put 

unit putc, fputc : write a 

can not be longer than NCARGS:50 

directory 



a file 

values fp_class : 

values fp_class : 

tolower, toascii : character 

inquiries ferror, feof, 

ypprot_err : yellow pages 

synchronization of jthe system 

ldclose, ldaclose : 

fclose, fflush : 

telldir, seekdir, rewind dir, 

system log syslog, openlog, 

space, 

cshrc : startup file for csh 

returning a stream to a remote 

rexec : return stream to a remote 

system : issue a shell 

system : execute a UNIX 

getarg, iargc : return 

ldclose, ldaclose : close a 

: read the file header of a 

number entries of a section of a 

to the optional file header of a 

entries of a section of a 

indexednamed section header of a 

to an indexednamed section of a 

indexed symbol table entry of a 

: seek to the symbol table of a 

ldopen, ldaopen : open a 

line number entries of a 

socket : create an endpoint for 

pipe : create an interprocess 

stcu : routines that provide a 

hypot, cabs : Euclidean distance, 

hwconf : get or set hardware 

on a socket 

getpeername : get name of 

socketpair : create a pair of 

: shut down part of a full-duplex 

accept : accept a 

connect : initiate a 

listen : listen for 

: control maximum system resource 

: control maximum system resource 

data cache cacheflush : flush 

: set and,or get signal stack 

fcntl : file 

ioctl : 



caller getuid, getgid ..... 
calloc, alloca : memory allocator 
calls rpc : library .... 
calls siginterrupt : .... 
calls and error numbers , 
capability data base . . . 
capability database .... 
cbrt, sqrt : cube root, square 
ceil* rint : absolute value, 
ceiling, and fabs, floor, ceil, 
change current working directory 
change data segment size 
change default directory 
change mode of a file 
change owner and group of a file 
change the action for a signal 
change the name of a file 
channel pipe : create . . 
character back into input stream 
character classification macros 
character from a logical unit 
character or word from stream 
character or word on a stream 
character to a fortran logical 
characters, as defined in ... 
chdir : change current working 
chdir ; change default directory 
chmod : change mode of a file 
chown : change owner and group of 
classes of IEEE floating-point 
classes of IEEE floating-point 
classification macros toupper, 
clearerr, fileno : stream status 
client interface yperr_string, 
clock correct the time to allow 
close : delete a descriptor . 
close a common object file 
close or flush a stream . . , 
closedir : directory operations 
closelog, setlogmask : control 
closepl : graphics interface 

command 

command ruserok : routines for 

command 

command ......... 

command ,....,..., 

command line arguments . . 
common object file .... 

common object file ldfhread 
common object file seek to line 
common object file : seek 
common object file to relocation 
common object file : read an 
common object file : seek 
common object file : read an 
common object file ldtbseek 
common object file for reading 
common object file function 

communication 

communication channel . . 
compilation unit symbol table 
complex absolute value . . . 
configuration information . . 
connect : initiate a connection 
connected peer ...... 

connected sockets . . . . , 

connection shutdown . . . 
connection on a socket . . . 
connection on a socket . . . 
connections on a socket . . 
consumption getrlimit, setrlimit 
consumption vlimit .... 

contents of instruction and, or 

context sigstack 

control 

control device . 



getuid(3f) 

malloc(3) 

rpc(3n) 

siginterrupt(3) 

intro(2) 

termcap(S) 

printcap(5) 

sqrt(3m) 

floor(3m) 

floor(3m) 

chdir(2) 

brk(2) 

chdfr(3f) 

chmod(3f) 

chown(2) 

signal(3f) 

rename(2) 

pipe(2) 

ungete(3s) 

ctype(3) 

getc(3f) 

getc(3s) 

putc(3s) 

putc(3f) 

wait(3f) 

chdir(2) 

ehdfr(3f) 

chmod(3f) 

ch0wn(2) 

fp_class(3) 

fp_class(3) 

ctype(3) 

ferror(3s) 

ypclnt(3n) 

adjtime(2) 

close(2) 

lddose(3x) 

fclose(3s) 

directory(3) 

syslog(3) 

plot(3x) 

cshrc(5) 

rcmd(3) 

rexec(3) 

systera(3) 

system(3f) 

getarg(3f) 

ldclose(3x) 

ldfhread(3x) 

ldlseek(3x) 

ldohseek(3x) 

ldrsee£(3x) 

ldshread(3x) 

ldsseek(3x) 

ldtbread(3x) 

ldtbseek(3x) 

ldopen(3x) 

ldlread(3x) 

socket(2) 

pipe(2) 

stcu(3) 

hypot(3m) 

hwconf(2) 

connect(2) 

getpeername(2) 

socketpair(2) 

shutdown(2) 

accept(2) 

connect(2) 

listen(2) 

getrlimit(2) 

vlimit(3c) 

cacheflush(2) 

sigstack(2) 

fcntl(2) 

ioctl(2) 
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getrlimit, setrlimit : 

consumption vlimit : 

fpc : floating-point 

fpc : floating-point 

openlog, closelog, setlogmask : 

virtually "hangup" the current 

ecvt, fcvt, gcvt : output 

sprintf : formatted output 

fscanf, sscanf ; formatted input 

ns_ntoa : Xerox NS(tm) address 

atof, atoi, atol : 

asctime, timezone, tzset : 

htonl, htons, ntohl, ntohs : 

fork : create a 

scalb ; copysign, remainder, 

drem, finite, logb, scalb ; 

synchronization of the adjtime : 

: trigonometric functions sin, 

sinh, 

fork: 

creat : 

a file for reading or writing, or 

fork : 

sockets socketpair : 

communication socket : 

communication channel pipe : 

umask : set file 

encryption 

cshrc : startup file for 

command 

asctime, timezone, tzset : 

system time time, 

cbrt, sqrt : 

: virtually "hangup" the 

setdomainname : get, set name of 

: get, set unique identifier of 

sethostname : get,set name of 

sigsetmask, sigmask : set 

chdir : change 

getcwd : get pathname of 

pathname getwd : get 

"optimal" cursor motion 

screen functions with "optimal" 

nfssvc, async_daemon : NFS 

termcap : terminal capability 

delete, firstkey, nextkey : 

dbm_error, dbm_clearerr : 

contents of instruction and, or 

: library routines for external 

brk, sbrk : change 

printcap ; printer capability 

settjmeofday : get, set 

time, ftime : get 

fdate : return 

timezone, tzset : convert 

jdate, itime : return 

dbmunextkey, dbm_error, 

base subroutines dbm_nextkey, 

firstkey, nextkey : data base 

dbm_clearerr : data base 

chdir : change 

than NCARGS:50 characters, as 

gtty : set and get terminal state 

close : 

base dbminit, fetch, store, 

getdiskbyname : get disk 

close ; delete a 

dup, dup2 : duplicate a 

ldgetpd : retrieve procedure 

descriptor given a procedure 

that provide access to per file 

getdtablesize : get 

access : 

access : 

access : 



control maximum system resource . . . , , getrlimit(2) 

control maximum system resource ,......,.. vlimit(3c) 

control registers £p c (3) 

control registers ........ fpc(3) 

control system log syslog, ............. syslog(3) 

control terminal vhangup : ............. vhangup(2) 

conversion ......,.,,,... ecvt(3) 

conversion printf, fprintf, printf(3s) 

conversion scanf, ................. scanf(3s) 

conversion routines ns_addr, . , ns(3n) 

convert ASCII to numbers . atof(3) 

convert date and time to ASCII ',...,'.»,... ctime(3) 

convert values between host and .......... byteorder(3n) 

copy of this process . . ......'.... fork(3f) 

copysign, drem, finite, logb, . » ieee(3m) 

copysign, remainder ? copysign, *..,,,...». ieee(3m) 

correct the time to allow .,..,.,.,..... adjtime(2) 

cos, tan, asin ? acos, atan ? atan2 ........... sin(3m) 

cosh, tanh : hyperbolic functions .......... sinh(3m) 

creat : create a new file ....... creat(2) 

create a copy of this process ............ fork(3f) 

create a new file ....,,..,,.....,.. creat(2) 

create a new file open : open .,,...-.,..••. open(2) 

create a new process .....,,. fork(2) 

create a pair of connected socketpair(2) 

create an endpoint for « . . . socket(2) 

create an interprocess ............... pipe(2) 

creation mode mask • • umask(2) 

crypt, setkey, encrypt : DBS . . . . • crypt(3) 

csh command cshrc(5) 

cshrc : startup file for csh ............. cshrc(5) 

ctime, localtime, gmtime, .....,.,....., ctime(3) 

ctime, ltime, gmtime : return ..•.'.•..,.... time(3f) 

cube root, square root .,.. f v ........ . sqrt(3m) 

current control terminal vhangup •••*......• vhangup(2) 

current domain getdomainname, ;......'... getdomainname(2) 

current host sethostid gethostid(2) 

current host gethostname, ,,.,•...•■..... gethostname(2) 

current signal mask ............... . sigsetmask(2) 

current working directory ....,...,.••••. chdir(2) 

current working directory getcwd (3f) 

current working directory getwd(3) 

curses : screen functions with ............ curses(3x) 

cursor motion curses : curses(3x) 

daemons nfssvc(2) 

data base , termcap(5) 

data base subroutines store, ............ dbm(3x) 

data base subroutines ............... ndbm(3) 

data cache cacheflush : flush ............ cacheflush(2) 

data representation xdr xdr(3n) 

data segment size brk(2) 

database ..................... printcap(S) 

date and time gettimeofday, ............ gettimeofday(2) 

date and time ................... time(3c) 

date and time in an ASCII string .......... fdate(3f) 

date and time to ASCII asctime, .......... ctime(3) 

date or time in numerical form ........... idate(3f) 

dbm^clearerr : database .............. ndbm(3) 

dbm_error, dbm_clearerr : data . ndbm(3) 

dbminit, fetch, store, delete, dbm(3x) 

dbmunextkey, dbm_>error, ............. ndbm(3) 

default directory ...» chdir(3f) 

defined in can not be longer ............ wait(3f) 

(defunct) stty, stty(3c) 

delete a descriptor close(2) 

delete, firstkey, nextkey : data ........... dbm(3x) 

description by its name . getdisk(3) 

descriptor close(2) 

descriptor ..................... dup(2) 

descriptor given a procedure ldgetpd(3x) 

descriptor index procedure ldgetpd(3x) 

descriptor section of the stfd(3) 

descriptor table size ................ getdtablesize(2) 

determine accessibility of a file ........... access(3f) 

determine accessibility of a file ........... access(3f) 

determine accessibility of file ............ access(2) 
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ioctl : control 

swapon : add a swap 

chdir : change current working 

chdir : change default 

: get pathname of current working 

scandir, alphasort : scan a 

independent getdirentries : gets 

unlink : remove 

unlink : remove a 

mkdir : make a 

rmdir : remove a 

seekdir, rewinddir, closedir : 

getwd : get current working 

and print the disassembler : 

instruction and print the 

file's in-core state with that on 

getdiskbyname : get 

quota : manipulate 

quotactl : manipulate 

unit mipsfpu : enabling and 

hypot, cabs : Euclidean 

res_mkquery, res_send, res_init, 

res_send, res_jnit, dn_comp, 

: get, set name of current 

publiclib : public 

copysign, remainder, copysign, 

time etime, 

descriptor 

dup, 

dup, dup2 : 

conversion 

end, etext, 

end, etext, 

a. out : assembler and link 

setregid : set real and 

setreuid : set real and 

new process in a virtual memory 

etime, dtime : return 

insque, remque : insert, remove 

emulation 

emulation 

emulate_b ranch : MIPS branch 

emul at e_b ranch : MIPS branch 

system setquota : 

floating-point unit mipsfpu : 

crypt, setkey, 

crypt, setkey, encrypt : DES 

locations in program 

locations in program 

getfsfile, getfstype, setfsent, 

getgrgid, getgrnam, setgrent, 

gethostent, sethostent, 

getmntent, setmntent, addmntent, 

getnetbyname, setnetent, 

getnetgrent, setnetgrent, 

socket : create an 

getprotobyname, setprotoent, 

getpwuid, getpwnam, setpwent, 

getservbyname, setservent, 

getttyent, getttynam, setttyent, 

getusershell, setusershell, 

nlist : get 

getdirentries : gets directory 

ldlitem : manipulate line number 

ldnlseek : seek to line number 

ldnrseek : seek to relocation 

endgrent : get group file 

innetgr : get network group 

getrpcbynumber : get RFC 

endttyent : get ttys file 

unlink : remove directory 

unlink : remove a directory 

ldgetaux : retrieve an auxiliary 

: read an indexed symbol table 

execvp, exec, execve, exect, 

getenv : get value of 



device . ioctl(2) 

device for interleaved swapon(2) 

directory chdir(2) 

directory chdir(3f) 

directory getcwd getcwd(3f) 

directory scandir(3) 

directory entries in a filesystem getdirentries(2) 

directory entry unlink(2) 

directory entry unlink(3f) 

directory file mkdir(2) 

directory file rmdir(2) 

directory operations telldir, directory(3) 

directory pathname getwd(3) 

disassemble a MIPS instruction disassembler(3x) 

disassembler : disassemble a MIPS disassembler(3x) 

disk fsync : synchronize a fsync(2) 

disk description by its name getdisk(3) 

disk quotas quota(2) 

disk quotas quotactl(2) 

dissabling the floating-point mipsfpu(2) 

distance, complex absolute value . hypot(3m) 

dn_comp, dn_expand : resolver resolver(3) 

dn_expand : resolver routines resolver(3) 

domain setdomainname getdomainname(2) 

domain packages written in Ada publiclib (3) 

drem, finite, logb, scalb : ieee(3m) 

dtime : return elapsed execution etime(3f) 

dup, dup2 : duplicate a dup(2) 

dup2 : duplicate a descriptor dup(2) 

duplicate a descriptor dup(2) 

ecvt, fcvt, gcvt : output ecvt(3) 

edata : last locations in program end(3) 

edata : last locations in program end(3) 

editor output , a.out(4) 

effective group ID setregid(2) 

effective user ID's setreuid(2) 

efficient way vfork : spawn vfork(2) 

elapsed execution time etime(3f) 

element from a queue , insque(3) 

emulate_branch : MIPS branch emulate__branch(3) 

emulate_branch : MIPS branch emulate_branch(3) 

emulation emulate_branch(3) 

emulation emulate_branch(3) 

enable, disable quotas on a file setquota(2) 

enabling and dissabling the mipsfpu(2) 

encrypt : DES encryption crypt(3) 

encryption crypt(3) 

end, etext, edata : last end(3) 

end, etext, edata : last . , . end(3) 

endfsent : get file getfsspec, getfsent(3) 

endgrent : get group file entry getgrent(3) 

endhostent : get network gethostbyname(3n) 

endmntent, hasmntopt : get file getmntent(3) 

endnetent : get network getnetent(3n) 

endnetgrent, innetgr : get * . . . . getnetgrent(3n) 

endpoint for communication socket(2) 

endprotoent : get getprotoent(3n) 

endpwent, setpwfile : get getpwent(3) 

endservent : get getservbyport, getservent(3n) 

endttyent : get ttys file entry , getttyent(3) 

endusershell : get legal user getusershell(3) 

entries from name list nlist(3x) 

entries in a filesystem getdirentries (2) 

entries of a common object file ldlread(3x) 

entries of a section of a common ldlseek(3x) 

entries of a section of a common .......... ldrseek(3x) 

entry getgrnam, setgrent, getgrent(3) 

entry setnetgrent, endnetgrent, getnetgrent(3n) 

entry getrpcent, getrpcbyname, . getrpcent(3n) 

entry getttynam, setttyent, getttyent(3) 

entry unlink(2) 

entry unlink(3f) 

entry, given an index ldgetaux(3x) 

entry of a common object file ldtbread(3x) 

environ : execute a file execlp, execl(3) 

environment variables getenv(3f) 
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setenv, unsetenv : manipulate 
first locations in program 
first locations in program 

erf, 

erf, erfc : 

sys_errlist, sys_nerr : system 

gerror, ierrno : get system 

introduction to system calls and 

program end, 

program end, 

ethers, ether_ntoa, 

ether_aton, ether_ntohost, 

ether_ntohost, ether_hostton, 

ether_ntohost, ethers, 

ethers, ether_ntoa, ether_aton, 

ether_ntohost, ether_hostton, 

execution time 

programs 

fixade : fix address 

execv, execle, execlp, execvp, 

execvp, exec, execve, exect, 

execve, exect, execl, execv, 

exect, execl, execv, execle, 

execlp, execvp, exec, execve, 

system : 

exec, execve, exect, environ : 

execve : 

specified time alarm : 

acct : 

sleep : suspend 

sleep : suspend 

•usleep : suspend 

monstartup, moncontrol '.prepare 

rex : remote 

etime, dtime : return elapsed 

profil : 

exec, execve, exect, execl, 

a execle, execlp, execvp, exec, 

execl, execv, execle, execlp, 

link : make a link to an 

flushing any pending output 

pow : exponential, logarithm, 

exponential, logarithm, exp, 

modf : split into mantissa and 

expml, log, loglO, loglp, pow : 

re_comp, re„exec : regular 

xdr : library routines for 

absolute value, floor, ceiling, 

: simplified software signal 

sigvec : software signal 

abort : generate a 

program eprol, _ftext, _idata, 

program eprol, Jftext, _fdata, 

stream 

ecvt, 

in program eprol, _jftext, 

in program eprol,. JEtext, 

an A SCII string 

fopen, f reopen, 

status inquiries f error, 

stream status inquiries 

nextkey : data base dbminit, 

fclose, 

operations bcopy, bemp, bzero, 

logical unit getc, 

word from stream getc, getchar, 

stream gets, 

: determine accessibility of 

: determine accessibility of a 

: determine accessibility of a 

acct : execution accounting 

chmod : change mode of a 



environmental variables getenv, getenv(3) 

eprol, _ftext, _fdata, _fbss : , end(3) 

eprol, „ftext, _fdata, Jfbss : end(3) 

erf, erfc : error functions erf(3m) 

erfc : error functions erf(3m) 

error functions ........ erf(3m) 

error messages perror, perror(3) 

error messages perror, perror(3f) 

error numbers intro : intro(2) 

etext, edata : last locations in end(3) 

etext, edata : last locations in end(3) 

ether^aton, ether_ntohost, ethers(3n) 

etherjhostton, etherjine : . . . , . ethers(3n) 

etherjine : Ethernet address . , ethers(3n) 

ether_jitoa, ether_aton, . ethers (3n) 

ether_jitohost, etherjhostton, . , . , , ethers(3n) 

ethers, ether_ntoa, ether_aton, ethers(3n) 

etime, dtime : return elapsed etime(3f) 

examples : library of sample ............ examples(3) 

exceptions (unaligned references) .......... fixade(2) 

exec, execve, exect, environ : execl(3) 

execl, execv, execle, execlp, execl(3) 

execle, execlp, execvp, exec, . . exccl(3) 

execlp, execvp, exec, execve, , execl(3) 

exect, environ : execute a file execl(3) 

execute a UNIX command ............. system(3f) 

execute a file execlp, execvp, ............ execl(3) 

execute a file ....... ...... execve(2) 

execute a subroutine after a alarm (3f) 

execution accounting file , . acct(5) 

execution for an interval sleep(3f) 

execution for interval sleep(3) 

execution for interval usleep(3) 

execution profile monitor, monitor(3) 

execution protocol • . . . . rex(3r) 

execution time etime(3f) 

execution time profile ............... profil (2) 

execv, execle, execlp, execvp, ............ execl(3) 

execve : execute a file execve(2) 

execve, exect, environ : execute ...... execl(3) 

execvp, exec, execve, exect, execl(3) 

existing file '.,,.......... link(3f) 

__exit : terminate a process . . exit(2) 

exit : terminate a process after exit(3) 

exp, expml, log, loglO, loglp, exp(3m) 

expml, log, loglO, loglp, pow : , . • . . exp(3m) 

exponent frexp, ldexp, . frexp(3) 

exponential, logarithm, power exp(3m) 

expression handler . , . . . . regex(3) 

external data representation , xdr(3n) 

fabs, floor, ceil, rint : floor(3m) 

facilities signal signal(3c) 

facilities sigvec(2) 

fault abort(3) 

Jfbss : first locations in end(3) 

Jnss : first locations in , , end(3) 

fclose, fflush : close or flush a fclose(3s) 

fcntl : file control fcntl(2) 

fevt, gcvt : output conversion ecvt(3) 

_idata, Jbss : first locations end(3) 

J:data, _fbss : first locations end(3) 

fdate : return date and time in fdate(3f) 

fdopen : open a stream fopen(3s) 

feof, clearerr, fileno : stream . . ferror(3s) 

ferror, feof, clearerr, fileno : ferror(3s) 

fetch, store, delete, firstkey, dbm(3x) 

fflush : close or flush a stream fclose(3s) 

ffs : bit and byte string . bstring(3) 

fgetc : get a character from a getc(3f) 

fgetc, getw : get character or . getc(3s) 

fgets : get a string from a gets(3s) 

file access access(2) 

file access access(3f) 

file access access(3f) 

file acct(5) 

file .......... , ...... chmod(3f) 
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: change owner and group of a 

creat : create a new 

exect, environ : execute a 

execve : execute a 

an advisory lock on an open 

setfsent, endfsent : get 

header of a member of an archive 

ldaclose : close a common object 

file header of a common object 

: retrieve symbol name for object 

of a section of a common object 

file header of a common object 

of a section of a common object 

section header of a common object 

section of a common object 

table entry of a common object 

symbol table of a common object 

link : make a hard link to a 

link : make a link to an existing 

mkdir : make a directory 

mknod : make a special 

or writing, or create a new 

rename : change the name of a 

rmdir : remove a directory 

symlink : make symbolic link to a 

fcntl : 

umask : set 

that provide access to per 

setgrent, endgrent : get group 

setttyent, endttyent : get ttys 

cshrc : startup 

ldaopen : open a common object 

create a new file open : open a 

number entries of a common object 

file ldfhread : read the 

ldohseek : seek to the optional 

mktemp : make a unique 

fseek, ftell : reposition a 

stat, lstat, fstat : get 

stat, fstat : get 

endmntent, hasmntopt : get 

mount : mount 

: enable,disable quotas on a 

unmount : remove a 

statfs : get 

utime : set 

utimes : set 

truncate, f truncate : truncate a 

ferror, feof, clearerr, 

: advisory record locking on 

disk fsync : synchronize a 

: gets directory entries in a 

: keep track of remotely mounted 

ttyname, isatty, ttyslot : 

ttynam, isatty : 

remainder, copysign, drem, 

dbminit, fetch, store, delete, 

references) fixade : 

(unaligned references) 

fpc : 

fpc : 

fpi: 

fpi: 

: generate a SIGFPE signal on 

: enabling and dissabling the 

fp_class : classes of IEEE 

fp_class : classes of IEEE 

advisory lock on an open file 

value, floor, ceiling, and fabs, 

ceil, rint : absolute value, 

unit 

fclose, fflush : close or 

and, or data cache cacheflush : 

flush : 

exit : terminate a process after 

stream 



file chown chown(2) 

file creat(2) 

file execvp, exec, execve, execl(3) 

file execve(2) 

file flock : apply or remove flock(2) 

file getfsfile, getfstype, getfsent(3) 

file ldahread : read the archive ldahread(3x) 

file ldclose, ldclose(3x) 

file ldfhread : read the ldfhread(3x) 

file ldgetname ldgetname(3x) 

file seek to line number entries ldlseek(3x) 

file : seek to the optional ldohseek(3x) 

file seek to relocation entries ldrseek(3x) 

file : read an indexednamed ldshread(3x) 

file : seek to an indexednamed ldsseek(3x) 

file : read an indexed symbol ldtbread(3x) 

file ldtbseek : seek to the ldtbseek(3x) 

file link(2) 

file link(3f) 

file mkdir(2) 

file mknod(2) 

file : open a file for reading open(2) 

file rename(2) 

file rmdir(2) 

file symlink(2) 

file control ....... fcntl(2) 

file creation mode mask umask(2) 

file descriptor section of the stfd(3) 

file entry getgrgid, getgrnam, getgrent(3) 

file entry getttyent, getttynam, getttyent(3) 

file for csh command , cshrc(5) 

file for reading ldopen, ldopen(3x) 

file for reading or writing, or . . open(2) 

file function : manipulate line ldlread(3x) 

file header of a common object ldfhread(3x) 

file header of a common object , ldohseek(3x) 

file name mktemp(3) 

file on a logical unit fseek(3f) 

file status stat(2) 

file status . . . , stat(3f) 

file system addmntent, , . getmntent(3) 

file system mount(2) 

file system setquota , . . . setquota(2) 

file system unmount(2) 

file system statistics statfs(2) 

file times . utime(3c) 

file times , utimes(2) 

file to a specified length truncate(2) 

fileno : stream status inquiries ferror(3s) 

files lockf lockf(3) 

file's in-core state with that on fsync(2) 

filesystem independent format . getdirentries(2) 

filesystems mount mount(3r) 

find name of a terminal , . ttyname(3) 

find name of a terminal port , ttynam(3f) 

finite, logb, scalb : copysign, ieee(3m) 

firstkey, nextkey : data base f . . . . dbm(3x) 

fix address exceptions (unaligned fixade(2) 

fixade : fix address exceptions , fixade(2) 

floating-point control registers fp c (3) 

floating-point control registers fpc(3) 

floating-point interrupt analysis fpi(3) 

floating-point interrupt analysis fpi(3) 

floating-point interrupts fp_sigintr(2) 

floating-point unit mipsfpu , mipsfpu(2) 

floating-point values fp_class(3) 

floating-point values . fp_class(3) 

flock : apply or remove an flock(2) 

floor, ceil, rint : absolute floor(3m) 

floor, ceiling, and fabs, floor, floor(3m) 

flush : flush output to a logical flush(3f) 

flush a stream fclose(3s) 

flush contents of instruction cacheflush(2) 

flush output to a logical unit flush(3f) 

flushing any pending output exit(3) 

fopen, freopen, fdopen : open a fopen(3s) 
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process 

return date or time in numerical 

in a filesystem independent 

scanf, fscanf, sscanf : 

printf, fprintf, sprintf : 

fputc : write a character to a 

registers 

registers 

floating-point values 

floating-point values 

analysis 

analysis 

output conversion printf, 

signal on floating-point 

fortran logical unit putc, 

word on a stream putc, put char, 

puts, 

input, output 

memory allocator malloc, 

fopen, 

mantissa and exponent 

conversion scanf, 

on a logical unit 

a stream 

stat, lstat, 

stat, 

in-core state with that on disk 

logical unit fseek, 

stream fseek, 

locations in program eprol, 

locations in program eprol, 

time, 

specified length truncate, 

shutdown : shut down part of a 

entries of a common object file 

Igamma : log gamma 

acosh, atanh : inverse hyperbolic 

erf, erfc : error 

intro : introduction to C library 

; introduction to FORTRAN library 

jO, jl, jn, yO, yl, yn : bessel 

to mathematical library 

acos, atan, atan2 : trigonometric 

sinh, cosh, tanh : hyperbolic 

a high-level interface to basic 

motion curses : screen 

input, output fread, 

Igamma : log 

print_unaligned_summary : 

print_unaligned_summary : 

ecvt, fcvt, 

uname : get 

floating-point fp_sigintr : 

abort : 

rand, srand : random number 

irand, srand : random number 

setstate : better random number 

messages perror, 

line arguments 

from a logical unit 

character or word from stream 

character or word from getc, 

working directory 

entries in a filesystem 

description by its name 

get,set name of current domain 

table size 

getgid, 

variables 

manipulate environmental 

getuid, 

getfstype, setfsent, endfsent : 

endfsent : getfsent, getfsspec, 

setfsent, endfsent : getfsent, 

getfsent, getfsspec, getfsfile, 



fork : create a copy of this ...... fork(3f) 

fork : create a new process fork (2) 

form idate, itime : , ....,» idate(3f) 

format : gets directory entries ........... getdir entries (2) 

formatted input conversion .....,, scanf (3s) 

formatted output conversion printf(3s) 

fortran logical unit putc, . putc(3f) 

fpc : floating-point control fpc(3) 

fpc : floating-point control ............. fpc(3) 

fp_class : classes of IEEE ............. fp_class(3) 

fp_class : classes of IEEE . , , fp„class(3) 

fpi : floating-point interrupt fpi(3) 

fpi : floating-point interrupt fpi(3) 

fprintf, sprintf : formatted ............. printf(3s) 

fp_sigintr : generate a SIGFPE fp„sigintr(2) 

fputc : write a character to a ............ putc(3f) 

fputc, putw : put character or . putc(3s) 

fputs : put a string on a stream . ...» puts(3s) 

fread, fwrite : buffered binary • fread(3s) 

free, realloc, calloc, alloca : malloc(3) 

freopen, fdopen : open a stream ..,..',..,. fopen(3s) 

frexp, ldexp, modf : split into frexp(3) 

fscanf, sscanf : formatted input scanf(3s) 

fseek, ftell : reposition a file fseek(3f) 

fseek, ftell, rewind : reposition fseek(3s) 

fstat : get file status ......,..*..•,.. stat(2) 

fstat : get file status , stat(3f) 

fsync : synchronize a file's ............. fsync(2) 

ftell : reposition a file on a ,....., fseek(3f) 

ftell, rewind : reposition a * fseek(3s) 

Jftext, _fdata, _fbss : first ....,.,...,... end(3) 

_itext, _idata, _fbss : first ...... end(3) 

ftime : get date and time \ \ time(3c)- 

ftruncate : truncate a file to a. truncate(2) 

full-duplex connection ............... shutdown(2) 

function manipulate line number ldlread(3x) 

function • ...,,.. lgamma(3m) 

functions asinh, asinh(3m) 

functions , . . , . . erf (3m) 

functions intro(3) 

functions intro intro(3f) 

functions j0(3m) 

functions math : introduction math(3m) 

functions sin, cos, tan, asin, ............ sin(3m) 

functions sinh(3m) 

functions needed that provide • stfe(3) 

functions with "optimal" cursor curses(3x) 

fwrite : buffered binary . fread(3s) 

gamma function lgamma(3m) 

gather statistics on unaligned unaligned(3) 

gather statistics on unaligned unaligned(3) 

gcvt : output conversion ecvt(3) 

general system information ...... uname(2) 

generate a SIGFPE signal on fp_sigintr(2) 

generate a fault . . . - - ■ abort(3) 

generator ..,.,.., rand(3c) 

generator rand, . rand(3f) 

generator; srandom, initstate, random(3) 

gerror, ierrno : get system error . . . . , perror(3f) 

getarg, iargc : return command ........... getarg(3f) 

getc, fgetc : get a character . « getc(3f) 

getc, getchar, fgetc, getw : get getc(3s) 

get char, fgetc, getw : get getc(3s) 

getcwd : get pathname of current getcwd(3f) 

getdirentries : gets directory ............. getdirentries(2) 

getdiskbyname : get disk getdisk(3) 

getdomainname, setdomainname : ,.....,.*. getdomainname(2) 

getdtablesize : get descriptor . ... » ...... . getdtablesize(2) 

getegid : get group identity getgid(2) 

getenv : get value of environment getenv(3f) 

getenv, setenv, unset env : getenv(3) 

geteuid : get user identity ,,......,.,.„. getuid(2) 

getfsent, getfsspec, getfsfile, , getfsent(3) 

getfsfile, getfstype, setfsent, ............. getfsent(3) 

getfsspec, getfsfile, getfstype, ............ getfsent(3) 

getfstype, setfsent, endfsent : getfsent(3) 
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the caller getuid, 

identity 

setgrent, endgrent : get group 

endgrent : get group getgrent, 

get group getgrent, getgrgid, 

sethostent, gethostbyname, 

gethostent, sethostent, 

gethostbyname, gethostbyaddr, 

unique identifier of current 

get, set name of current host 

value of interval timer 



endmntent, hasmntopt : get file 

setnetent, endnetent getnetent, 

getnetent, getnetbyaddr, 

getnetbyname, setnetent, 

endnetgrent, innetgr : get 

argv 

size 

connected peer 



identification 

identification getpid, 

get, set program scheduling 

getprotoent, getprotobynumber, 

setprotoent, getprotoent, 

getprotobyname, setprotoent, 

setpwent, endpwent, setpwfile : 

setpwfile' : getpwent, getpwuid, 

endpwent, setpwfile : getpwent, 

maximum system resource 

get RPC entry getrpcent, 

getrpcent, getrpcbyname, 

getrpcbynumber ; get RPC entry 

resource utilization 

filesystem getdirentries : 

stream 

getservent, getservbyport, 

setservent, getservent, 

getservbyname, setservent, 

gettimeofday, settimeofday : 

getdomainname, setdomainname : 

gethostname, sethostname : 

getpriority, setpriority : 

current gethostid, sethostid : 

getitimer, setitimer : 

set options on sockets 

get, set date and time 

endttyent : get ttys file entry 

get ttys file entry getttyent, 

identity 

group ID of the caller 

endusershell : get legal user 

stream getc, getchar, fgetc, 

directory pathname 

: retrieve procedure descriptor 

: retrieve an auxiliary entry, 

time, ctime, ltime, 

: convert ctime, localtime, 

setjmp, longjmp : non-local 

space, closepl : 

: subroutines for the HP 2648 

getpgrp : get process 

killpg : send signal to a process 

setpgrp : set process 

setregid : set real and effective 

setegid, setrgid : set user and 

getuid, getgid : get user or 

getgroups : get 



getgid : get user or group ID of . . . , getuid(3f) 

getgid, getegid : get group getgid(2) 

getgrent, getgrgid, getgrnam, getgrent(3) 

getgrgid, getgrnam, setgrent, .,,.., getgrent(3) 

getgrnam, setgrent, endgrent : getgrent(3) 

getgroups : get group access list getgroups(2) 

gethostbyaddr, gethostent, • ♦ . . , . . gethostbyname(3n) 

gethostbyname, gethostbyaddr, gethostbyname(3n) 

gethostent, sethostent, gethostbyname(3n) 

gethostid, sethostid : get, set gethostid(2) 

gethostname, sethostname : ............. gethostname(2) 

getitimer, setitimer : get, set . f getitimer(2) 

getlog : get user's login name .,..,, getlog(3f) 

getlogin : get login name .............. getlogin(3) 

getmntent, setmntent, addmntent, getrantent(3) 

getnetbyaddr, getnetbyname, getnetent(3n) 

getnetbyname, setnetent, getnetent(3n) 

getnetent, getnetbyaddr, .............. getnetent(3n) 

getnetgrent, setnetgrent, . , getnetgrent(3n) 

getopt : get option letter from getopt(3) 

getpagesize : get system page getpagesize(2) 

getpass : read a password getpass(3) 

getpeername : get name of getpeername(2) 

getpgrp : get process group ........ getpgrp(2) 

getpid : get process id getpid(3f) 

getpid, getppid : get process getpid(2) 

getppid : get process . . . . . . . getpid(2) 

getpriority, setpriority : getpriority(2) 

getprotobyname, setprotoent, . . . . . . getprotoent(3n) 

getprotobynumber, getprotobyname, getprotoent(3n) 

getprotoent, getprotobynumber, , , . , . getprotoent(3n) 

getpw : get name from uid ............. getpw(3c) 

getpwent, getpwuid, getpwnam, getpw ent(3) 

getpwnam, setpwent, endpwent, getpwent(3) 

getpwuid, getpwnam, setpwent, getpwent(3) 

getrlimit, setr limit : control getrlimit(2) 

getrpcbyname, getrpcbynumber : getrpcent(3n) 

getrpcbynumber : get RPC entry .......... getrpcent(3n) 

getrpcent, getrpcbyname, getrpcent(3n) 

getrpcport : get RPC port number getrpcport(3r) 

getrusage : get information about getrusage(2) 

gets directory entries in a .............. getdirentries(2) 

gets, fgets ; get a string from a ........... gets(3s) 

getservbyname, setservent, getservent(3n) 

getservbyport, getservbyname, getservent(3n} 

getservent, getservbyport, getservent(3n) 

get,set date and time . gettimeofday(2) 

get,set name of current domain getdomainname(2) 

get,set name of current host gethostname(2) 

get,set program scheduling getpriority(2) 

get, set unique identifier of gethostid(2) 

get,set value of interval timer getitimer(2) 

getsockname : get socket name getsockname(2) 

getsockopt, setsockopt : get and , getsockopt(2) 

gettimeofday, settimeofday : . . . . gettimeofday(2) 

getttyent, getttynam, setttyent, getttyent(3) 

getttynam, setttyent, endttyent : . . getttyerit(3) 

getuid, geteuid : get user getuid(2) 

getuid, getgid : get user or getuid(3f) 

getusershell, setusershell, . getusershell(3) 

getw : get character or word from getc(3s) 

getwd : get current working getwd(3) 

given a procedure descriptor ............ ldgetpd(3x) 

given an index ldgetaux ldgetaux(3x) 

gmtime : return system time ............ time(3f) 

gmtime, asctime, timezone, tzset ctime(3) 

goto setjmp(3) 

graphics interface • plot(3x) 

graphics terminal lib2648 Iib2648(3x) 

group getpgrp(2) 

group killpg(2) 

group setpgrp(2) 

group ID setregid(2) 

group ID setruid, setgid, • • setuid(3) 

group ID of the caller getuid(3f) 

group access list getgroups(2) 
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initgroups : initialize 

setgroups : set 

innetgr : get network 

setgrent, endgrent : get 

getgid, getegid : get 

chown : change owner and 

(defunct) stty, 

reboot ; reboot system or 

re^exec : regular expression 

print„unaligned_summary : gather 

print__unaligned,_summary : gather 

terminal vhangup : virtually 

link : make a 

information hwconf : get or set 

setmntent, addmntent, endmntent, 

ldfhread : read the file 

: seek to the optional file 

: read an indexednamed section 

file Idahread : read the archive 

stfe : routines that provide a 

unique identifier of current 

: get, set name of current 

ntohs : convert values between 

convert values between host and 

values between host and htonl, 

configuration information 

asinh, acosh, atanh : inverse 

sinh, cosh, tanh : 

complex absolute value 

arguments getarg, 

getpid : get process 

time in numerical form 

getpid, getppid : get process 

sethostid : get,set unique 

getgid, getegid : get group 

getuid, geteuid : get user 

messages perror, gerror, 

machines rquota : 

fsync : synchronize a file's 

tgetstr, tgoto, tputs : terminal 

directory entries in a filesystem 

an auxiliary entry, given an 

given a procedure descriptor 

strncmp, strcpy, strncpy, strlen, 

common object Idtbread : read an 

ldshread, Idnshread : read an 

Idsseek, Idnsseek : seek to an 

syscall : 

inetjatoa, inet__makeaddr, 

inet_ntoa, inet_makeaddr, 

inetJietwork, inet_ntoa, 

inet_jnak;eaddr, inet_lnaof, 

inet_makeaddr, inet„addr, 

inet_addr, inet_network, 

get or set hardware configuration 

uname : get general system 

utilization getrusage : get 

utilization v times : get 

rnusers, rusers : return 

access list 

initgroups : 

popen, pclose : 

connect : 

random number random, srandom, 

setnetgrent, endnetgrent, 

read, readv : read 

scanf, fscanf, sscanf : formatted 

ungetc : push character back into 

fread, fwrite : buffered binary 

stdio : standard buffered 

clearerr, fileno : stream status 

queue insque, remque : 

element from a queue 

disassembler : disassemble a MIPS 

cacheflush : flush contents of 

abs : 



group access list .< . , . 
group access list . . . • 
group entry endnetgrent ? 
group file entry getgraam, 
group identity ..... 

group of a file ..,.,. 
gtty : set and get terminal state 
halt processor ...... 

handler re_comp, .... 

handle_unalignecLtraps, 
handle_unaligned„traps, . 
"hangup" the current control 
hard link to a file , . . , 
hardware configuration . . 
hasmntopt : get file system 
header of a common object file 
header of a common object file 
header of a common object file 
header of a member of an archive 
high-level interface to basic 
host sethostid : get, set . . . 
host gethostname, sethostname 
host and network byte order 
htonl, htons, ntohl, ntohs : 
htons, ntohl, ntohs : convert 
hwconf : get or set hardware 
hyperbolic functions . . . , 
hyperbolic functions .... 

hypot, cabs : Euclidean distance 
iargc : return command line . 

id . , 

idate, itime : return date or 

identification . 

identifier of current host . . 

identity , . 

identity .......... 

ierrno : get system error . • 
implement quotas on remote 
in^-core state with that on disk 
independent tgetnum, tgetflag, 
independent format : gets 
index ldgetaux : retrieve . . 
index procedure descriptor . 
index, strchr, rindex, strrchr, 
indexed symbol table entry of a 
indexednamed section header of a 
indexednamed section of a common 
indirect system call ..... 

inet_addr, inet_jnetwork, • * 
inet_lnaof, inet_.net of : Internet 
inet_makeaddr, inetjnaof, 
inet_netof : Internet inetjntoa, 
inet„network, inet_ntoa, . . 
inetjntoa, inet__makeaddr, 
information hwconf : ... 
information ........ 

information about resource 
information about resource 
information about users on remote 
initgroups : initialize group • - . 
initialize group access list .... 

initiate 1,0 to,from a process . . 
initiate a connection on a socket 
initstate, setstate : better .... 

innetgr : get network group entry 
input ....... 

input conversion . . 
input stream .... 

input,output .... 

input, output package 
inquiries ferror, feof, 
insert,remove element from a 
insque, remque : insert,remove 
instruction and print the results 
instruction and, or data cache 
integer absolute value . . . 



initgroups (3) 

setgroups(2) 

getnetgrent(3n) 

getgrent(3) 

getgid(2) 

chown(2) 

stty(3c) 

reboot(2) 

regex(3) 

unaligned(3) 

unaligned(3) 

vhangup(2) 

link(2) 

hwconf(2) 

getmntent(3) 

ldfhread(3x) 

ldohseek(3x) 

ldshread(3x) 

ldahread(3x) 

stfe(3) 

gethostid(2) 

gethostname(2) 

byteorder(3n) 

byteorder(3n) 

byteorder(3n) 

hwconf(2) 

asinh(3ra) 

sinh(3m) 

hypot(3m) 

getarg(3f) 

getpid(3f) 

idate(3f) 

getpid(2) 

gethostid(2) 

getgid(2) 

getuid(2) 

perror(3f) 

rquota(3r) 

fsync(2) 

term cap (3x) 

getdirentries(2) 

ldgetaux(3x) 

ldgetpd(3x) 

string(3) 

ldtbread(3x) 

ldshread(3x) 

ldsseek(3x) 

syscall(2) 

inet(3n) 

inet(3n) 

inet(3n) 

inet(3n) 

inet(3n) 

inet(3n) 

hwconf(2) 

uname(2) 

getrusage(2) 

vtimes(3c) 

rnusers(3r) 

initgroups(3) 

initgroups (3) 

popen(3) 

connect(2) 

random (3) 

getnetgrent(3n) 

read(2) 

scanf(3s) 

ungetc(3s) 

fread(3s) 

stdio(3s) 

ferror(3s) 

insque(3) 

insque(3) 

disassembler(3x) 

cacheflush(2) 

abs(3) 
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: multiple precision 

space, closepl : graphics 

a compilation unit symbol table 

ypprot_err : yellow pages client 

needed that provide a high-level 

that provide a binary read write 

; routines that provide scalar 

swapon : add a swap device for 

channel pipe : create an 

blocked signals and wait for 

fpi : floating-point 

fpi : floating-point 

siginterrupt : allow signals to 

a SIGFPE signal on floating-point 

sleep : suspend execution for 

sleep : suspend execution for an 

usleep : suspend execution for 

setitimer : get, set value of 

functions 

library functions 

calls and error numbers 

functions intro : 

functions intro : 

library functions math : 

error numbers intro ; 

asinh, acosh, atanh : 

returns :1 if it was not 

generator rand, 

islower, isdigit, isxdigit, 

isdigit, isxdigit, isalnum, 

isprint, isgraph, iscntrl, 

port ttynam, 

terminal ttynam e, 

ispunct, isprint, isgraph, 

isalpha, isupper, islower, 

isspace, ispunct, isprint, 

isalnum, isalpha, isupper, 

isalnum, isspace, ispunct, 

isxdigit, isalnum, isspace, 

isdigit, isxdigit, isalnum, 

system : 

isxdigit, isalnum, isalpha, 

isupper, islower, isdigit, 

numerical form idate, 

functions 

functions jO, 

}0,jl, 

filesystems mount : 

kopt : get or set 



group 

file ldclose, 

header of a member of an archive 

file for reading ldopen, 

common object file 

and exponent frexp, 

of a common object file 

entry, given an index 

for object file 

descriptor given a procedure 

line number entries of ldlread, 

entries of a ldlread, ldlinit, 

manipulate line number entries 

number entries of a section of a 

entries of a section of ldlseek, 

entries of a section of Idrseek, 

section header of a ldshread, 

indexednamed section of ldsseek, 

file header of a common object 

obj ect file for reading 

relocation entries of a section 

indexednamed section header of a 

indexednamed section of a common 



integer arithmetic mppx) 

interface plot(3x) 

interface routines that provide * . .. . stcu(3) 

interface yperr_string, ....... ypclnt(3n) 

interface to basic functions stfe(3) 

interface to the MIPS symbol . » . stio(3) 

interfaces to auxiliaries staux staux(3) 

interleaved paging,swapping swapon(2) 

interprocess communication . pipe(2) 

interrupt : atomically release sigpause(2) 

interrupt analysis , fpi(3) 

interrupt analysis . . . . fpi(3) 

interrupt system calls siginterrupt(3) 

interrupts fp_sigintr : generate fp_sigintr(2) 

interval . sleep(3) 

interval sleep(3f) 

interval usleep(3) 

interval timer getitimer, getitimer(2) 

intro : introduction to C library . intro(3) 

intro : introduction to FORTRAN . . intro(3f) 

intro : introduction to system ....*. intro(2) 

introduction to C library intro(3) 

introduction to FORTRAN library intro(3f) 

introduction to mathematical math(3m) 

introduction to system calls and intro(2) 

inverse hyperbolic functions . asinh(3m) 

invoked by the super-user( . , initgroups(3) 

ioctl : control device ioctl(2) 

irand, srand : random number rand(3f) 

isalnum, isspace, ispunct, ctype(3) 

isalpha, isupper, islower, ctype(3) 

isascii, toupper, tolower, ctype(3) 

isatty : find name of a terminal ........... ttynam(3f) 

isatty, ttyslot : find name of a ttyname(3) 

iscntrl, isascii, toupper, . , . ctype(3) 

isdigit, isxdigit, isalnum, ctype(3) 

isgraph, iscntrl, isascii, ctype(3) 

islower, isdigit, isxdigit, ctype(3) 

isprint, isgraph, iscntrl, ctype(3) 

ispunct, isprint, isgraph, ctype(3) 

isspace, ispunct, isprint, ctype(3) 

issue a shell command ............... system (3) 

isupper, islower, isdigit, . ctype(3) 

isxdigit, isalnum, isspace, ctype(3) 

itime : return date or time in , idate(3f) 

jO, jl, jn, yO, yl, yn ; bessel j0(3m) 

jl, jn, yO, yl, yn : bessel . . . j0(3m) 

jn, yO, yl, yn : bessel functions j0(3m) 

keep track of remotely mounted ........... mount(3r) 

kernel options kopt(2) 

kill : send a signal to a process kill(3f) 

kill : send signal to a process kill(2) 

killpg : send signal to a process killpg(2) 

kopt : get or set kernel options . kopt(2) 

ldaclose ; close a common obj ect ldclose(3x) 

ldahread : read the archive ldahread(3x) 

ldaopen : open a common object ldopen(3x) 

ldclose, ldaclose : close a ldclose(3x) 

ldexp, modf : split into mantissa frexp(3) 

ldfhread : read the file header ldfhread(3x) 

ldgetaux : retrieve an auxiliary . , ldgetaux(3x) 

ldgetname : retrieve symbol name ldgetname(3x) 

ldgetpd : retrieve procedure , . ldgetpd(3x) 

ldlinit, ldlitem : manipulate ldlread(3x) 

ldlitem : manipulate line number .......... ldlread(3x) 

ldlread, ldlinit, ldlitem : ldlread(3x) 

ldlseek, ldnlseek : seek to line ldlseek (3x) 

ldnlseek : seek to line number ldlseek(3x) 

Idnrseek : seek to relocation ldrseek(3x) 

ldnshread : read an indexednamed ldshread(3x) 

ldnsseek : seek to an ldsseek(3x) 

ldohseek : seek to the optional ldohseek(3x) 

ldopen, ldaopen : open a common . ldopen(3x) 

Idrseek, Idnrseek : seek to . ldrseek(3x) 

ldshread, ldnshread : read an ldshread(3x) 

ldsseek, ldnsseek : seek to an ldsseek(3x) 
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table entry of a common object 

table of a common object file 

setusersheU, endusershell : get 

string 

: truncate a file to a specified 

len : return 

getopt : get option 

2648 graphics terminal 

VADS libraries : overview of VADS 

libraries VADS 

standard : VADS standard 

intro : introduction to C 

jntro : introduction to FORTRAN 

: introduction to mathematical 

examples : 

verdixlib : MlPS-supported Ada 

data representation xdr : 

procedure calls rpc : 

getarg, iargc : return command 

Idlinit, Idlitem : manipulate 

oi; a ldlseek, Idniseek : seek to 

: read value of a symbolic 

file 

a. out : assembler and 

link : make a hard 

symlink : make symbolic 

link : make a 

getgroups : get group access 

: initialize group access 

nlist : get entries from name 

setgroups : set group access 

varargs : variable argument 

on a socket 

socket listen : 

obj ect 

timezone, tzset : ctime, 

end, etext, edata : last 

end, etext, edata : last 

„_ftext, ^fdata, Jfcss : first 

_ftext, „fdata, _ibss : first 

; apply or remove an advisory 

on files 

lockf : advisory record 

setlogmask : control system 

lgamma : 

exponential, exp, expml ? 

logarithm, exp, expml, log, 

exp, expml, log, loglO, 

loglO, loglp, pow : exponential, 

copysign, drem, finite, 

flush : flush output to a 

ft ell •■: reposition a file on a 

fgetc : get a character from a 

: write a character to a fortran 

getlog : get user's 

getlogin : get 

to terrain at esystem(3f) can not be 

setjmp, 

stat, 

time time ? crime, 

information about users on remote 

: implement quotas on remote 

rwall : write to specified remote 

: character classification 

alloca : memory allocator 

quota : 

quotactl : 

getenv, setenv, unset env : 

a ldlread, Idiinit, Idlitem : 

frexp, Idexp, modf : split into 

mmap, munraap : 

ether Jine : Ethernet address 

uncacheable cachectl : 



Idtbread : read an indexed symbol • .,.<.',..,. ldtbread(3x) 

Idtb seek : seek to the symbol ..<,,,..',,.. ldtbseek(3x) 

legal user shells getusershell, -,.•,...,,,'.... getusershell(3) 

len : return length of Fortran ,.,,,,„,,-,,. len(3f) 

length truncate, f truncate ....... , truncate(2) 

length of Fortran string .,.....,...,... len(3f) 

letter from argv ,.,,.,-,..'.. getopt(3) 

lgamma : log gamma function ,..,,«-,,,... lgamroa(3m) 

lib2648 : subroutines for the HP , , ,,.,., . ,'■ , : , , lib2648(3x) 

libraries ......,..„>...,.. libraries(3) 

libraries : overview of VADS .,,,,.•,......, libraries(3) 

library ....,.,...,•..,',',.',.,.., standard(3) 

library functions . . . , . .. . . . , . « . ..., * « . . intro(3) 

library functions ......'.,.'..,,..,.,. intro(3f) 

library functions math ......,.,,....„ math(3ni) 

library of sample programs ..-.,,*,,,,,., examples(3) 

library packages ...•...',••,.-,<,,•'«.. verdixlib(3) 

library routines for external ....,,,,.,..., xdr(3n) 

library routines for remote ..,„..,, t .... . rpc(3n) 

line arguments • , ..,....,.,..■.'... . getarg(3f) 

line number entries of a common >„.,«...,., ldlread(3x) 

line number entries of a section ........... ldlseek (3x) 

link readlink • « «...-«• P ., f ... . readlink(2) 

link : make a hard link to a file .,..„*,.,., link(2) 

link : make a link to an existing ,,,,....... link(3f) 

link editor output <....,.,••,.,,,,.. a.out(4) 

link to a file ...,........,>......, link(2) 

link to a file ,,,,,.,,.. symlink(2) 

link to an existing file .,,..,,,-,.•,,'.. link(3f) 

list ,....,..».,...,. getgroups(2) 

list initgroups ,.•...,,.. <v ,..,. , : »., . initgroups(3) 

list ...,,,........ . , ....''.... «, nlist(3x) 

list .',,.........,., V , v f .-'••,,. . setgroups(2) 

list „ . . varargs(3) 

listen : listen for connections .•,,,.'..'*,.. listen(2) 

listen for connections on a .....,.,„,>.. listen(2) 

loc : return the address of an .,>.'-.",,....«•• loc(3f) 

localtime, gmtime, asctime, ,,..,,....... ctitne(3) 

locations in program ....,,,.,.,..,,.„ end(3) 

locations in program .......,,....,,. end(3) 

locations in program eprol, ............ end(3) 

locations in program eprol, ............ end(3) 

lock on an open file flock . „ ..»■.'« , . » , , . . flock(2) 

lockf : advisory record locking ,.,..,,,... lockf(3) 

locking on files .. ..,...,,,..,,., . lockf(3) 

log syslog, openlog, closelog, . . , , '..,,,,'•• . syslog(3) 

log gamma function ■ . . . . . . ........ . . . . , lgarama(3m) 

log, loglO, loglp, pow : . . . . . , . , . ■, . . • . . exp(3m) 

loglO, loglp, pow : exponential, .....,..,., exp(3m) 

loglp, pow : exponential, ,,,•-.,',. exp(3m) 

logarithm? power expml, log, . *.-.'• • • • ;• •? • . exp(3m) 

logb, scalb : copysign, ..,.,,,''.,',•'-....<. jeee(3m) 

logical unit .,..,,•.,,.,.,,;,.,;•,< flush(3f) 

logical unit fseek, .,....,...<..,..-*.•,. fseek;(3f) 

logical unit getc, ..........a..*,.. getc(3f) 

logical unit putc, fputc . . . . . * . * * f # . . « . putc(3f) 

login name •,.••'....,,.,...,,,,-,,, getlog(3f) 

login name ..,......,,......,., getlogin(3) 

longer than NCARGS: 50 characters, . . - . . . . . . wait(3f) 

longjmp : non-local goto *•••««.•• * * , . . setjmp(3) 

Iseek : move read,write pointer .»..,,.«,... lseek(2) 

Istat, fstat : get file status . . , ... . .. « ' > » * . . stat(2) 

ltime, gmtime : return system . . . , . , . , t » . . time(3Q 

machines rusers : return ...,,.,,.,,,.. rnusers(3r) 

machines rquota .......... . f f . . , . . rquota(3r) 

machines ...,.., t .,..,, ■» ., f , . .. . . rwall(3r) 

macros toupper, tolower, toascii > .. ■* * , ,., • . . ctype(3) 

malloc, free, realloc, calloc ? , , . , ' , ' . . . ... • malloc(3) 

manipulate disk quotas , . . . . . , , '• , , > .... quota(2) 

manipulate disk quotas . . . . >.., , , . , ' . , . . . quotactl(2) 

manipulate environmental ,,,.».,,,,,,, getenv(3) 

manipulate line number entries of ,,,,*,',',-,, ldlread(3x) 

mantissa and exponent ...... . , ....... . frexp(3) 

map or unmap pages of memory , » , , , . '• , R . » mmap(2) 

mapping operations . . . . , , . . * . , , , . . • . ethers(3n) 

mark pages cacheable or ...... ^ , . , ..... . pachectl(2) 
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sigmask : set current signal 

umask : set file creation mode 

mathematical library functions 

math : introduction to 

getrlimit, setrlimit : control 

consumption vlimit : control 

: read the archive header of a 

memset : memory memory) 

memory memory) memccpy, 

memory) memccpy, memchr, 

memory) memccpy, memchr, memcmp, 

munmap : map or unmap pages of 

memcpy, memset : memory 

free, realloc, calloc, alloca : 

valloc : aligned 

: spawn new process in a virtual 

memchr, memcmp, memcpy, memset : 

memccpy, memchr, memcmp, memcpy, 

recvfrom, recvmsg : receive a 

send, sendto, sendmsg : send a 

sys_nerr : system error 

gerror, ierrno : get system error 

sys_siglist : system signal 

the floating-point unit 



of memory 
umask : set file creation 
chmod : change 
exponent frexp, ldexp, 
profile monitor, monstartup, 
prepare execution profile- 
execution profile monitor, 
functions with "optimal" cursor 
mounted filesystems 

mount : 

mount : keep track of remotely 

lseek : 

arithmetic : 

select : synchronous 1,0 

memory mmap, 

: get disk description by its 

getlog : get user's login 

getlogin : get login 

getsockname : get socket 

mktemp : make a unique file 

Idgetname : retrieve symbol 

getpw : get 

nlist : get entries from 

rename : change the 

ttyname, isatty, ttyslot : find 

ttynam, isatty : find 

getpeername : get 

setdomainname : get, set 

sethostname : get,set 

bind : bind a 

interface to basic functions 

sethostent, endhostent : get 

setnetent, endnetent : get 

convert values between host and 

endnetgrent, innetgr : get 

fetch, store, delete, firstkey, 

daemons 

list 

setjmp, longjmp : 

address conversion routines 

conversion routines ns_addr, 

between host and htonl, htons, 

host and htonl, htons, ntohl, 

getrpcport : get RPC port 

file ldlitem : manipulate line 

ldlseek, ldnlseek : seek to line 

rand, srand : random 



mask sigsetmask, sigsetmask(2) 

mask umask(2) 

math : introduction to math(3m) 

mathematical library functions math(3m) 

maximum system resource getrlimit(2) 

maximum system resource , vlimit(3c) 

member of an archive file ldahread(3x) 

memccpy, memchr, memcmp, memcpy, memory(3) 

memchr, memcmp, memcpy, memset : memory(3) 

memcmp, memcpy, memset : memory memory(3) 

memcpy, memset : memory . memory(3) 

memory mmap, . mmap(2) 

memory) memccpy, memchr, memcmp, memory(3) 

memory allocator malloc, malloc(3) 

memory allocator valloc(3c) 

memory efficient way vfork vfork(2) 

memory operations memccpy, memory (3) 

memset : memory operations memory(3) 

message from a socket recv, recv(2) 

message from a socket send(2) 

messages perror, sys^errlist, perror(3) 

messages perror, perror(3f) 

messages psignal, ......... psignal(3) 

mipsfpu : enabling and dissabling mipsfpu(2) 

mkdir : make a directory file . mkdir(2) 

mknod : make a special file mknod(2) 

mktemp : make a unique file name mktemp(3) 

mmap, munmap : map or unmap pages mmap(2) 

mode mask umask(2) 

mode of a file chmod(3f) 

modf : split into mantissa and frexp(3) 

moncontrol : prepare execution monitor(3) 

monitor, monstartup, moncontrol : monitor(3) 

monstartup, moncontrol : prepare monitor(3) 

motion curses : screen . curses(3x) 

mount : keep track of remotely mount(3r) 

mount : mount file system mount(2) 

mount file system mount(2) 

mounted filesystems mount(3r) 

move read,write pointer . lseek(2) 

multiple precision integer mp(3x) 

multiplexing select(2) 

munmap : map or unmap pages of mmap(2) 

name getdiskbyname getdisk(3) 

name , . , getlog(3f) 

name getlogin(3) 

name getsockname(2) 

name mktemp(3) 

name for object file ldgetname(3x) 

name from uid getpw(3c) 

name list nlist(3x) 

name of a file . rename(2) 

name of a terminal ttyname(3) 

name of a terminal port . . ttynam(3f) 

name of connected peer getpeername(2) 

name of current domain getdomainname(2) 

name of current host gethostname(2) 

name to a socket , bind(2) 

needed that provide a high-level stfe(3) 

network gethostent, gethostbyname(3n) 

network getnetbyname, getnetent(3n) 

network byte order ntohl, ntohs byteorder(3n) 

network group entry setnetgrent, getnetgrent(3n) 

nextkey : data base subroutines dbm(3x) 

nfssvc, async_daemon : NFS nfssvc(2) 

nice : set program priority nice(3c) 

nlist : get entries from name nlist(3x) 

non-local goto , setjmp(3) 

ns_addr, ns_jitoa : Xerox NS(tm) ns(3n) 

ns_ntoa : Xerox NS(tm) address ns(3n) 

ntohl, ntohs : convert values byteorder(3n) 

ntohs ; convert values between byteorder(3n) 

number getrpcport(3r) 

number entries of a common object ldlread(3x) 

number entries of a section of a ldlseek (3x) 

number generator rand(3c) 
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rand, irand, srand : random 
setstate : better random 
atoi, atol : convert ASCII to 
to system calls and error 
itime : return date or time in 
loc : return the address of an 
Idaclose : close a common 
read the file header of a common 
: retrieve symbol name for 
entries of a section of a common 
optional file header of a common 
entries of a section of a common 
section header of a common 
indexednamed section of a common 
symbol table entry of a common 
to the symbol table of a common 
Idopen, ldaopen : open a common 
line number entries of a common 
writing, or create a new file 
reading Idopen, ldaopen : 
writing, or create a new open : 
fopen, freopen, fdopen : 
or remove an advisory lock on an 
seekdir, rewinddir, closedir : 
control system log syslog, 
bzero ? ffs : bit and byte string 
rewinddir, closedir : directory 
: Ethernet address mapping 
memcmp, memcpy, memset : memory 
strspn, strcspn, strtok : string 
curses : screen functions with 
getopt : get 
object Idohseek : seek to the 
kopt : get or set kernel 
setsockopt : get and set 
between host and network byte 
a. out : assembler and link editor 
after Hushing any pending 
write, writev : write 
ecvt, fcvt, gcvt : 
fprintf, sprintf : formatted 
flush : flush 
VADS libraries : 
chown : change 
: standard buffered input,output 
: MlPS-supported Ada library 
publiclib : public domain 
getpagesize : get system 
: update user password in yellow 
cachectl : mark 
yperr_string, ypprot_err : yellow 
mmap, munmap : map or unmap 
add a swap device for interleaved 
socketpair : create a 
shutdown : shut down 
getpass : read a 
endpwent, setpwfile : get 
yppasswd : update user 
: get current working directory 
directory getcwd : get 

process popen, 

: get name of connected 

a process after flushing any 

: routines that provide access to 

system error messages 

system error messages 

communication channel 

Iseek : move read,write 

to,from a process 

isatty : find name of a terminal 

getrpcport : get RFC 

exp, expml, log, loglO, loglp, 

pow : exponential, logarithm, 

: multiple 

monitor, monstartup, moncontrol : 



number generator ..... 

number generator; initstate, 
numbers at of, ...... 

numbers intro ; introduction 
numerical form idate, . . * 
object .......... 

object file Idclose, ..... 

object file ldfhread ; .... 

object file Idgetname . . -.. 
object file seek to line number 
object file : seek to the . . . 
object file : seek to relocation 
object file read an indexednamed 
object file : seek to an .... 

object file < read an indexed , 
object file Idtbseek : seek . * 
object file for reading . . . , 
object file function manipulate 
open : open a file for reading or 
open a common object file for 
open a file for reading or . . 
open a stream ....... 

open file flock : apply ". . . 
opendir, readdir, telldir, . . 
openlog, closelog, setlogmask : 
operations bcopy, bcmp, • 
operations telldir, seekdir, 
operations etherjine ... 
operations memccpy, memchr, 
operations strrchr, strpbrk, 
"optimal" cursor motion . , 
option letter from argv . , , 
optional file header of a common 
options .......... 

options on sockets getsockopt, 
order ntohs : convert values 
output ...,.?..,. 
output : terminate a process 
output .......... 

output conversion . , . . . 
output conversion printf, 
output to a logical unit . * . 
overview of VADS libraries • ■ 
owner and group of a file . . 
package stdio ....... 

packages verdixlib 

packages written in Ada . . 

page size 

pages yppasswd ...... 

pages cacheable or uncacheable 
pages client interface . . , . 
pages of memory . . . * . 
paging, swapping swapon : * 
pair of connected sockets 
part of a full-duplex connection 
password ,.,..,•••• 

password getpwnam, setpwent, 
password in yellow pages . . 

pathname getwd 

pathname of current working 
pause : stop until signal . . 
pclose ; initiate 1,0 to,from a 
peer getpeername ..... 
pending output exit : terminate 
per file descriptor section of 
perror, gerror, ierrno : get f 
perror, sys^errlist, sys^nerr : 
pipe : create an interprocess 

pointer . 

popen, pclose : initiate 1,0 

port ttynam, * 

port number ...,,.. 
pow : exponential, logarithm, 
power expml, log, loglO, loglp. 
precision integer arithmetic 
prepare execution profile . , 



rand(3f) 

random(3) 

atof(3) 

intro(2) 

idate(3f) 

loc(3f) 

ldclose(3x) 

ldfhread(3x) 

ldgetname(3x) 

ldlseek(3x) 

ldohseek(3x) 

ldrseek(3x) 

ldshread(3x) 

ldsseek(3x) 

ldtbread(3x) 

ldtbseek(3x) 

ldopen(3x) 

ldlread(3x) 

op en (2) 

ldopen(3x) 

open(2) 

fopen(3s) 

flock(2) 

direetory(3) 

syslog(3) 

bstring(3) 

directory(3) 

ethers(3n) 

memory(3) 

string(3) 

curses(3x) 

getopt(3) 

Idohseek (3x) 

kopt(2) 

getsockopt(2) 

byteorder(3n) 

a.out(4) 

exit(3) 

write(2) 

ecvt(3) 

printf(3s) 

flush(3f) 

libraries(3) 

chown(2) 

stdio(3s) 

verdixlib (3) 

publiclib (3) 

getpagesize(2) 

yppasswd(3r) 

cachectl(2) 

ypclnt(3n) 

mmap(2) 

swapon(2) 

socketpair (2) 

shutdown(2) 

getpass(3) 

getpwent(3) 

yppasswd(3r) 

getwd(3) 

getcwd(3f) 

pause(3c) 

popen(3) 

getpeername(2) 

exit(3) 

stfd(3) 

perror(3f) 

perror(3) 

pipe(2) 

lseek(2) 

popen(3) 

ttynam(3f) 

getrpcport(3r) 

exp(3m) 

exp(3m) 

mp(3x) 

monitor(3) 
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a MIPS instruction and 

stprint : routines to 

database 

printcap : 

formatted output conversion 

handle_unaligned_traps, 

handle__unaligned_traps, 

: get, set program scheduling 

nice : set program 

rpc : library routines for remote 

procedure ldgetpd : retrieve 

procedure descriptor given a 

_procedure_string_table : runtime 

_procedure_string_table : runtime 

procedure _procedure_table_size, 

procedure _procedure_table_size, 

_procedure_table_size, 

_procedure__table_size, 

_procedure_table, 

_procedure_table, 

_exit : terminate a 

fork : create a new 

fork : create a copy of this 

kill : send signal to a 

kill : send a signal to a 

pclose : initiate 1,0 to,from a 

pending exit : terminate a 

getpgrp : get 

killpg : send signal to a 

setpgrp : set 

getpid : get 

getpid, getppid : get 

efficient way vfork : spawn new 

times : get 

wait, wait3 ; wait for 

can not be wait : wait for a 

ptrace : 

reboot : reboot system or halt 

moncontrol : prepare execution 

profil : execution time 

abort : terminate Fortran 

etext, edata : last locations in 

last locations in 

; first locations in 

; first locations in 

nice : set 

setpriority : get,set 

assert : 

examples : library of sample 

rex : remote execution 

interface stio : routines that 

table stcu : routines that 

basic stfe : routines that 

descriptor stfd : routines that 

staux : routines that 

signal messages 

Ada publiclib : 

packages written in Ada 

stream ungetc : 

puts, fputs : 

putc, putchar, fputc, putw : 

to a fortran logical unit 

character or word on a stream 

character or word on a putc, 

stream 

stream putc, putchar, fputc, 



: insert, remove element from a 
qsort : 
qsort : 

quota : manipulate disk 



etext, edata : 
_fbss ; 
_fbss : 



print the results : disassemble disassembler(3x) 

print the symbol table , stprint(3) 

printcap : printer capability , printcap(5) 

printer capability database printcap(5) 

printf , fprintf, sprintf : printf(3s) 

printjun align ed_summary : gather .......... unaligned(3) 

print_un align ed_summary : gather unaligned (3) 

priority setpriority getpriority(2) 

priority nice(3c) 

procedure calls rpc(3n) 

procedure descriptor given a ldgetpd(3x) 

procedure descriptor index ldgetpd(3x) 

procedure table ,end(3) 

procedure table end(3) 

_procedure_string_table : runtime end(3) 

_procedure_string_table : runtime end(3) 

_procedure_table, end(3) 

__procedure_table, end(3) 

_procedure_table_size, end(3) 

_procedure_table_size, . end(3) 

process . exit(2) 

process , , fork(2) 

process . fork(3f) 

process kill(2) 

process kill(3f) 

process popen, popen(3) 

process after flushing any exit(3) 

process group getpgrp(2) 

process group killpg(2) 

process group . setpgrp(2) 

process id getpid(3f) 

process identification getpid(2) 

process in a virtual memory vfork(2) 

process times times(3c) 

process to terminate wait(2) 

process to terminatesystem(3f) . . . . wait(3f) 

process trace ptrace(2) 

processor . reboot(2) 

profil : execution time profile profil(2) 

profile monitor, monstartup, monitor(3) 

profile profil(2) 

program abort(3f) 

program end, end(3) 

program end, end(3) 

program eprol, _ftext, _fdata, end(3) 

program eprol, _ftext, _fdata, , end(3) 

program priority nice(3c) 

program scheduling priority getpriority(2) 

program verification assert(3) 

programs examples(3) 

protocol rex(3r) 

provide a binary read write , stio(3) 

provide a compilation unit symbol stcu(3) 

provide a high-level interface to stfe(3) 

provide access to per file . . . . . stfd(3) 

provide scalar interfaces to staux(3) 

psignal, sys_siglist : system psignal(3) 

ptrace : process trace ptrace(2) 

public domain packages written in publiclib (3) 

publiclib : public domain publiclib (3) 

push character back into input ungetc(3s) 

put a string on a stream . , puts(3s) 

put character or word on a stream putc(3s) 

putc, fputc : write a character putc(3f) 

putc, putchar, fputc, putw : put putc(3s) 

putchar, fputc, putw : put putc(3s) 

puts, fputs : put a string on a puts(3s) 

putw : put character or word on a putc(3s) 

qsort : quick sort , . . qsort(3f) 

qsort : quicker sort , . qsort(3) 

queue insque, rem que insque(3) 

quick sort qsort(3f) 

quicker sort qsort(3) 

quota : manipulate disk quotas quota(2) 

quotactl : manipulate disk quotas . . . . , quotactl(2) 

quotas quota(2) 
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quotactl : manipulate disk 

setquota : enable,disable 

rquota : implement 

number generator 

generator 

rand, srand : 

rand, irand, srand : 

initstate, setstate : better 

setstate : better random number 

routine for the ranhashinit, 

access routine for the symbol 

the symbol ranhashinit, ranhash, 

routines for returning a stream 

getpass : 

entry of a common Idtbread : 

header of ldshread, ldnshread : 

read, readv : 

member of an archive Idahread : 

object file ldfhread : 

readlink : 

: routines that provide a binary 

rewinddir, closedir : opendir, 

: open a common object file for 

new file open : open a file for 

symbolic link 

read, 

lseek : move 

setregid : set 

setreuid : set 

allocator m alloc, free, 

processor 

reboot : 

recv, recvfrom, recvmsg : 

expression handler 

lockf : advisory 

a message from a socket 

message from a socket recv, 

a socket recv, recvfrom, 

handler re_comp, 

fix address exceptions (unaligned 

: gather statistics on unaligned 

: gather statistics on unaligned 

fpc : floating-point control 

fpc : floating-point control 

re„comp, re_exec : 

for sigpause : atomically 

of a Idrseek, ldnrseek : seek to 

finite, logb, scalb : copysign, 

for returning a stream to a 

rexec : return stream to a 

rex : 

return information about users on 

rquota : implement quotas on 

rwall : write to specified 

rpc : library routines for 

mount : keep track of 

unlink : 

rmdir : 

unmount : 

Open file flock : apply or 

unlink : 

from a queue insque, 

file 

unit fseek, ftell : 

fseek, ftell, rewind : 

routines for external data 

resolver resjmkquery, res„send, 

dn„comp, dn^expand : resolver 

resjnit, dn_comp, dn_expand ; 

: control maximum system 

vlimit : control maximum system 

getrusage : get information about 

vtimes : get information about 

dn^expand : res_mkquery, 

a MIPS instruction and print the 



quotas ■ . . . . quotactl(2) 

quotas on a file system , . setquota(2) 

quotas on remote machines , . rquota(3r) 

rand, irand, srand : random , rand(3f) 

rand, srand : random number , . rand(3c) 

random number generator rand(3c) 

random number generator . rand(3f) 

random number generator; , . random(3) 

random, srandom, initstate, ............ random (3) 

ranhash, ranlookup : access , ranhash(3x) 

ranhashinit, ranhash, ranlookup : ranhash(3x) 

ranlookup : access routine for ........... ranhash(3x) 

rcmd, rresvport, ruserok : , ■ ■ . . . rcmd(3) 

read a password ...... getpass(3) 

read an indexed symbol table ldtbread(3x) 

read an indexednamed section ldshread(3x) 

read input . • ' ,.....,.. read(2) 

read, readv : read input .............. read(2) 

read the archive header of a ............ ldahread(3x) 

read the file header of a common . ldfhread(3x) 

read value of a symbolic link '.'......,.... readlink(2) 

read write interface to the MIPS ......... , . . . stio(3) 

readdir, telldir, seekdir, ............... directory(3) 

reading Id open, ldaopen ldopen(3x) 

reading or writing, or create a ............ open(2) 

readlink : read value of a ....... readlink(2) 

readv : read input , read (2) 

read, write pointer lseek(2) 

real and effective group ID setregid(2) 

real and effective user IP's ,.,.........,. setreuid(2) 

realloc, calloc, alloca : memory malloc(3) 

reboot : reboot system or halt ..,.,,..,... reboot(2) 

reboot system or halt processor ........... reboot(2) 

receive a message from a socket recv(2) 

re__comp, re_exee : regular ....,,...»... regex(3) 

record locking on files lockf(3) 

recv, recvfrom, recvmsg : receive ......... B recv(2) 

recvfrom, recvmsg : receive a ...».*....., recv(2) 

recvmsg : receive a message from .......... recv(2) 

re_exec : regular expression ....... , .... , regex(3) 

references) fixade : . , fixade(2) 

references unaligned(3) 

references .,....-. unaligned(3) 

registers fpc(3) 

registers fpc(3) 

regular expression handler regex(3) 

release blocked signals and wait sigpause(2) 

relocation entries of a section . ldrseek(3x) 

remainder, copysign, drem, ieee(3m) 

remote command : routines rcmd(3) 

remote command . rexec(3) 

remote execution protocol .,.,.,......• rex(3r) 

remote machines rusers : rnusers(3r) 

remote machines . rquota(3r) 

remote machines »,.».,.....»,.... rwall(3r) 

remote procedure calls ............... rpc(3n) 

remotely mounted filesystems mount(3r) 

remove a directory entry ,.....,.. unlink(3f) 

remove a directory file ................ rm^ir(2) 

remove a file system unmount(2) 

remove an advisory lock on an ........... flock(2) 

remove directory entry unlink(2) 

remque : insert,remove element ........... insque(3) 

rename : change the name of a ........... rename(2) 

reposition a file on a logical fseek(3f) 

reposition a stream ,.•••..,. fseek(3s) 

representation xdr : library '. • xdr(3n) 

res_init, dn^comp, dn^expand : ........... resolver(3) 

res_mkquery, res_send, res_init, ........... resolver(3) 

resolver routines res_send, ............. resolver(3) 

resource consumption setrlimit ............ getrlimit(2) 

resource consumption vlimit(3c) 

resource utilization getrusage(2) 

resource utilization . * vtimes(3e) 

res^send, res_init, dn^comp, resolver(3) 

results : disassemble disassembler(3x) 
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given an index Idgetaux : 

given a procedure ldgetpd : 

file ldgetname : 

getarg, iargc : 

string fdate : 

form id ate, itime : 

etime, dtime : 

sigreturn : 

remote rnusers, rusers : 

len : 

rexec : 

time, ctime, ltime, gmtime : 

loc : 

rresvport, ruserok : routines for 

by the super-user( 

fseek, ft ell, 

readdir, telldir, seekdir, 

command 
strncpy, strlen, index, strchr, 
ceiling, and fabs, floor, ceil, 

information about users on 

cbrt, sqrt : cube root, square 

cbrt, sqrt : cube 

ranhash, ranlookup : access 

Xerox NS(tm) address conversion 

dn_comp, dn_expand : resolver 

representation xdr : library 

calls rpc : library 

to a rcmd, rresvport, ruserok : 

read write interface to stio : 

compilation unit symbol stcu : 

high-level interface to stfe : 

per file descriptor stfd : 

interfaces to staux : 

table stprint : 

procedure calls 

remote machines 

returning a stream to a rcmd, 

_procedure_string^table : 

_procedure_string_table : 

a stream to a rcmd, rresvport, 

users on remote rnusers, 

machines 

examples : library of 

brk, 

staux : routines that provide 

copysign, drem, finite, logb, 

scandir, alphasort : 

directory 

input conversion 

time alarm : 

time ualarm : 

setpriority : get, set program 

cursor motion curses : 

ldnshread : read an indexednamed 

seek to line number entries of a 

: seek to relocation entries of a 

: seek to an indexednamed 

access to per file descriptor 

of a common ldsseek, ldnsseek : 

section of a ldlseek, ldnlseek : 

section of a ldrseek, ldnrseek : 

of a common object ldohseek : 

common object file ldtbseek : 

opendir, readdir, telldir, 

brk, sbrk : change data 

multiplexing 

send, sendto, sendmsg : 

kill : 

message from a socket 

kill : 

killpg : 

socket send, sendto, 

from a socket send, 



retrieve an auxiliary entry, ldgetaux(3x) 

retrieve procedure descriptor ldgetpd(3x) 

retrieve symbol name for object ldgetname(3x) 

return command line arguments getarg(3f) 

return date and time in an ASCII fdate(3f) 

return date or time in numerical idate(3f) 

return elapsed execution time etime(3f) 

return from signal . sigreturn(2) 

return information about users on rnusers(3r) 

return length of Fortran string len(3f) 

return stream to a remote command rexec(3) 

return system time time(3f) 

return the address of an object loc(3f) 

returning a stream to a remote rcmd(3) 

returns :1 if it was not invoked - initgroups(3) 

rewind : reposition a stream fseek(3s) 

rewinddir, closedir : directory directory(3) 

rex : remote execution protocol rex(3r) 

rexec : return stream to a remote rexec(3) 

rindex, strrchr, strpbrk, strspn, string(3) 

rint : absolute value, floor, floor(3m) 

rmdir : remove a directory file rmdir(2) 

rnusers, rusers : return rnusers(3r) 

root sqrt(3m) 

root, square root sqrt(3m) 

routine for the symbol table ranhash(3x) 

routines ns_addr, ns_ntoa : ns(3n) 

routines res_send, res_init, resolver(3) 

routines for external data xdr(3n) 

routines for remote procedure rpc(3n) 

routines for returning a stream rcmd(3) 

routines that provide a binary stio(3) 

routines that provide a stcu(3) 

routines that provide a stfe(3) 

routines that provide access to stfd(3) 

routines that provide scalar staux(3) 

routines to print the symbol stprint(3) 

rpc : library routines for remote rpc(3n) 

rquota : implement quotas on „ rquota(3r) 

rresvport, ruserok : routines for . , rcmd(3) 

runtime procedure table end(3) 

runtime procedure table end(3) 

ruserok : routines for returning rcmd(3) 

rusers : return information about rnusers(3r) 

rwall : write to specified remote rwall(3r) 

sample programs examples(3) 

sbrk : change data segment size . brk(2) 

scalar interfaces to auxiliaries staux(3) 

scalb : copysign, remainder, ieee(3m) 

scan a directory scandir(3) 

scandir, alphasort : scan a scandir(3) 

scanf, fscanf, sscanf : formatted scanf(3s) 

schedule signal after specified alarm (3c) 

schedule signal after specified ualarm(3) 

scheduling priority getpriority, getpriority(2) 

screen functions with "optimal" curses(3x) 

section header of a common object ldshread(3x) 

section of a common object file ldlseek(3x) 

section of a common object file ldrseek(3x) 

section of a common object file , . . . ldsseek(3x) 

section of the that provide stfd(3) 

seek to an indexednamed section ldsseek(3x) 

seek to line number entries of a ldlseek(3x) 

seek to relocation entries of a ldrseek(3x) 

seek to the optional file header ldohseek(3x) 

seek to the symbol table of a ldtbseek(3x) 

seekdir, rewinddir, closedir : directory(3) 

segment size brk(2) 

select : synchronous 1,0 select(2) 

send a message from a socket send(2) 

send a signal to a process kill(3f) 

send, sendto, sendmsg : send a send(2) 

send signal to a process kill(2) 

send signal to a process group killpg(2) 

sendmsg : send a message from a send(2) 

sendto, sendmsg : send a message send(2) 
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(defunct) stty, gtty : 

context sigstack ; 

sigsetmask, sigmask : 

umask : 

utime : 

utimes : 

setgroups : 

information hwconf : get or 

kopt : get or 

getsockopt, setsockopt : get and 

setpgrp : 

nice : 

setregid : 

setreuid : 

setgid, setegid, setrgid : 

assign buffering to a stream 

buffering to a stream setbuf, 

current domain getdomainname, 

setuid, seteuid, setruid, setgid, 

environmental variables getenv, 

setegid, setrgid : set setuid, 

getfsspec, getfsfile, getfstype, 

user setuid, seteuid, setruid, 

getgrent, getgrgid, getgrnam, 

gethostbyaddr, gethostent, 

identifier of current gethostid, 

current host gethostname, 

interval timer getitimer, 

crypt, 

a stream setbuf, setbuffer, 

syslog, openlog, closelog, 

hasmntopt : get file getmntent, 

getnetbyaddr, getnetbyname, 

: get network group getnetgrent, 

scheduling priority getprjority, 

getprotobynumber, getprotobyname, 

getpwent, getpwuid, getpwnam, 

getpwnam, setpwent, endpwent, 

on a file system 

group ID 

user ID's 

setruid, setgid, setegid, 

system resource getrlimit, 

: set user and setuid, seteuid, 

getservbyport, getservbyname, 

on sockets getsockopt, 

random, srandom, initstate, 

time gettimeofday, 

file entry getttyent, getttynam, 

setegid, setrgid : set user and 

legal user shells getusershell, 

system : issue a 

endusershell : get legal user 

connection shutdown ; 

full-duplex connection 

interrupt system calls 

sigsetmask, 

pause : stop until 

signal : change the action for a 

sigreturn : return from 

signal 

signal facilities 

alarm : schedule 

ualarm : schedule 

signal : simplified software 

sigvec : software 

sigsetmask, sigmask : set current 

psignal, sys_siglist : system 

fp_sigintr : generate a SIGFPE 

sigstack : set and,or get 

kill : send 

kill : send a 



set and get terminal state ....... stty(3c) 

set and, or get signal stack . sigstack(2) 

set current signal mask ....-, sigsetmask(2) 

set file creation mode mask ....... • umask(2) 

set file times ..*..... utime(3c) 

set file times utimes(2) 

set group access list . , ... , ......... . setgroups(2) 

set hardware configuration hwconf(2) 

set kernel options . . kopt(2) 

set options on sockets getsockopt(2) 

set process group ........... setpgrp(2) 

set program priority . . f ........ • nice(3c) 

set real and effective group ID setregid(2) 

set real and effective user ID's setreuid(2) 

set user and group ID setruid, setuid(3) 

setbuf, setbuffer, setlinebuf : . . setbuf(3s) 

setbuffer, setlinebuf : assign ............. setbuf(3s) 

setdomainname : get,set name of getdomainname(2) 

setegid, setrgid : set user and . f . . . setuid(3) 

setenv, unsetenv : manipulate getenv(3) 

seteuid, setruid, setgid, setuid(3) 

setfsent, endfsent : get file . getfsent(3) 

setgid, setegid, setrgid ; set setuid(3) 

setgrent, endgrent ; get group getgrent(3) 

setgroups : set group access list ........... setgroups(2) 

sethostent, endhostent : get gethostbyname(3n) 

sethostid ; get, set unique .............. gethostid(2) 

sethostname : get, set name of .,..,..,.... gethostname(2) 

setitimer : get, set value of . . , ......... . getitimer(2) 

setjmp, longjmp : non-local goto . . , setjmp(3) 

setkey, encrypt : DES encryption crypt(3) 

setlinebuf ; assign buffering to , . . , . setbuf(3s) 

setlogmask : control system log ........... syslog(3) 

setmntent, addmntent, endmntent, getmntent(3) 

setnetent, endnetent : get getnetent(3n) 

setrjietgrent, endnetgrent, innetgr .......... getnetgrent(3n) 

setpgrp : set process group setpgrp(2) 

setpriority : get,set program ............. getpriority(2) 

setprotoent, endprotoent : get getprotoent(3n) 

setpwent, endpwent, setpwfile : ........... getpwent(3) 

setpwfile ; get password . getpwent(3) 

setquota ; enable, disable quotas ........... setquota(2) 

setregid : set real and effective setregid(2) 

setreuid : set real and effective ......... f . setreuid(2) 

setrgid ; set user and group ID ........... setuid(3) 

setrlimit : control maximum . getrlimit(2) 

setruid, setgid, setegid, setrgid ........... setuid(3) 

setservent, endservent : get ............. getservent(3n) 

setsockopt : get and set options , , getsockopt(2) 

setstate : better random number random(3) 

settimeof day : get,set date and , gettimeofday(2) 

setttyent, endttyent : get ttys getttyent(3) 

setuid, seteuid, setruid, setgid, ........... setuid(3) 

setusershell, endusershell : get getusershell(3) 

shell command • system(3) 

shells setusershell, \ . . . getusershell(3) 

shut down part of a fulWuiplex . , shutdown(2) 

shutdown : shut down part of a . . . . shutdown(2) 

sigblock '; block signals • sigblock(2) 

siginterrupt ; allow signals to siginterrupt(3) 

sigmask : set current signal mask sigsetmask(2) 

signal pause(3c) 

signal .,.,.' f signal(3f) 

signal sigreturn(2) 

signal : change the action for a ........... signal(3f) 

signal : simplified software ............. signal(3c) 

signal after specified time alarm(3c) 

signal after specified time ualarm(3) 

signal facilities signal(3c) 

signal facilities sigvec(2) 

signal mask sigsetmask(2) 

signal messages psignal(3) 

signal on floating-point fp_sigintr(2) 

signal stack context ................ sigstack(2) 

signal to a process ................. kill(2) 

signal to a process kill(3f) 
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killpg : send 

sigblock : block 

: atomically release blocked 

siginterrupt : allow 

blocked signals and wait for 

signal mask 

stack context 

facilities 

facilities signal : 

atan2 : trigonometric functions 

functions 

brk, sbrk : change data segment 

: get descriptor table 

getpagesize : get system page 

interval 

interval 

accept : accept a connection on a 

bind : bind a name to a 

: initiate a connection on a 

: listen for connections on a 

: receive a message from a 

sendmsg : send a message from a 

communication 

getsockname : get 

connected sockets 

: get and set options on 

: create a pair of connected 

signal : simplified 

sigvec : 

qsort : quicker 

qsort : quick 

interface 

memory efficient way vfork : 

mknod : make a 

ftruncate : truncate a file to a 

rwall : write to 

alarm : schedule signal after 

: execute a subroutine after a 

ualarm : schedule signal after 

frexp, ldexp, modf : 

conversion printf, fprintf, 

cbrt, 

cbrt, sqrt : cube root, 

rand, 

rand, irand, 

better random number random, 

conversion scanf, fscanf, 

sigstack : set and, or get signal 

package stdio : 

standard : VADS 

cshrc : 

status 

statistics 

statfs : get file system 

print„unaligned_summary : gather 

print_unaligned_summary : gather 

stat, Istat, fstat : get file 

stat, fstat : get file 

feof, clearerr, fileno : stream 

scalar interfaces to auxiliaries 

compilation unit symbol table 

input,output package 

access to per file descriptor 

high-level interface to basic 

binary read write interface to 

pause : 

: database dbminit, fetch, 

symbol table 

strcpy, strncpy, strlen, index, 

strcpy, strncpy, strlen, index, 

strlen, index, strcat, strncat, 

strcat, strncat, strcmp, strncmp, 

rindex, strrchr, strpbrk, strspn, 



signal to a process group killpg(2) 

signals sigblock(2) 

signals and wait for interrupt sigpause(2) 

signals to interrupt system calls siginterrupt(3) 

sigpause : atomically release sigpause(2) 

sigreturn : return from signal . . . . sigreturn(2) 

sigsetmask, sigmask : set current sigsetmask(2) 

sigstack : set and, or get signal sigstack(2) 

sigvec : software signal sigvec(2) 

simplified software signal signal(3c) 

sin, cos, tan, asin, acos, atan, * . . sin(3m) 

sinh, cosh, tanh : hyperbolic sinh(3m) 

size brk(2) 

size getdtablesize . getdtablesize(2) 

size getpagesize(2) 

sleep : suspend execution for an sleep(3f) 

sleep : suspend execution for sleep(3) 

socket accept(2) 

socket . bind(2) 

socket connect connect(2) 

socket listen listen(2) 

socket recv, recvfrom, recvmsg . , recv(2) 

socket send, sendto, send(2) 

socket : create an endpoint for socket(2) 

socket name , getsockname(2) 

socketpair : create a pair of socketpair(2) 

sockets getsockopt, setsockopt . , getsockopt(2) 

sockets socketpair socketpair(2) 

software signal facilities signal(3c) 

software signal facilities . . . . • sigvec(2) 

sort qsort(3) 

sort qsort(3f) 

space, closepl : graphics plot(3x) 

spawn new process in a virtual vfork(2) 

special file mknod(2) 

specified length truncate, truncate(2) 

specified remote machines rwall(3r) 

specified time alarm(3c) 

specified time alarm alarm(3f) 

specified time ualarm(3) 

split into mantissa and exponent frexp(3) 

sprintf : formatted output ...... printf (3s) 

sqrt : cube root, square root sqrt(3m) 

square root sqrt(3m) 

srand : random number generator rand(3c) 

srand : random number generator rand(3f) 

srandom, initstate, setstate : random(3) 

sscanf : formatted input scanf(3s) 

stack context sigstack(2) 

standard : VADS standard library standard(3) 

standard buffered input, output stdio(3s) 

standard library standard(3) 

startup file for csh command , cshrc(5) 

stat, fstat : get file status stat(3f) 

stat, lstat, fstat : get file stat(2) 

statfs : get file system statfs(2) 

statistics statfs(2) 

statistics on unaligned unaligned(3) 

statistics on unaligned unaligned(3) 

status , stat(2) 

status stat(3f) 

status inquiries ferror, . ferror(3s) 

staux : routines that provide staux(3) 

stcu : routines that provide a stcu(3) 

stdio : standard buffered stdio(3s) 

stfd : routines that provide stfd(3) 

stfe : routines that provide a stfe(3) 

stio : routines that provide a stio(3) 

stop until signal pause(3c) 

store, delete, firstkey, nextkey dbm(3x) 

stprint : routines to print the stprint(3) 

strcat, strncat, strcmp, strncmp, string(3) 

strchr, rindex, strrchr, strpbrk, , string(3) 

strcmp, strncmp, strcpy, strncpy, string(3) 

strcpy, strncpy, strlen, index, string(3) 

strcspn, strtok : string strchr, string(3) 
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fclose, fflush : close or flush a 

fopen, freopen, fdopen : open a 

ft ell, rewind : reposition a 

getw : get character or word from 

gets ? fgets : get a string from a 

putw : put character or word on a 

puts 3 fputs : put a string on a 

: assign buffering to a 

: push character back into input 

ferror, feof, clearerr, fileno : 

: routines for returning a 

rexec : return 

return date and time in an ASCII 

len : return length of Fortran 

timezone : supply timezone 

gets, fgets : get a 

puts, fputs : put a 

bcmp, bzero, ffs : bit and byte 

strspn, strcspn, strtok : 

strcmp, strncmp, strcpy, strncpy, 

strncpy, strlen, index, strcat, 

index, strcat, strncat, strcmp, 

strncat, strcmp, strncmp, strcpy, 

index, strchr, rindex, strrchr, 

strlen, index, strchr, rindex, 

strchr, rindex, strrchr, strpbrk, 

strpbrk, strspn, strcspn, 

state (defunct) 

alarm : execute a 

firstkey, nextkey : data base 

dbm_clearerr : data base 

graphics terminal lib2648 : 

sync : update 

:1 if it was not invoked by the 

timezone : 

sleep : 

sleep : 

usleep : 

swab : 

paging, swapping swapon : add a 

interleaved paging, swapping 

ldgetname : retrieve 

: access routine for the 

read write interface to the MIPS 

stprint : routines to print the 

Id thread : read an indexed 

that provide a compilation unit 

file ldtbseek : seek to the 

readlink : read value of a 

symlink : make 

file 

: correct the time to allow 

state with that on disk fsync : 

select : 

error messages perror, 

setlogmask : control system log 

perror, sys_errlist, 

messages psignal, 

endmntent, hasmntopt : get file 

mount : mount file 

: enable, disable quotas on a file 

unmount : remove a file 



syscall : indirect 

: allow signals to interrupt 

intro : introduction to 

to allow synchronization of the 

perror, sys_errlist, sys„nerr : 

perror, gerror, ierrno : get 

uname : get general 

closelog, setlogmask : control 

reboot : reboot 



stream fclose(3s) 

stream fopen(3s) 

stream fseek, fseek(3s) 

stream getc, getchar, fgetc, ............. getc(3s) 

stream gets(3s) 

stream putc, putchar, fputc, . putc(3s) 

stream puts(3s) 

stream setbuffer, setlinebuf * setbuf(3s) 

stream ungetc ungetc(3s) 

stream status inquiries . ferror(3s) 

stream to a remote command . rcmd(3) 

stream to a remote command • rexec(3) 

string fdate : . fdate(3f) 

string len(3f) 

string , • timezone(3) 

string from a stream . . . . gets(3s) 

string on a stream ........... puts(3s) 

string operations bcopy, .............. bstring(3) 

string operations strpbrk, string(3) 

strlen, index, strchr, rindex, , string(3) 

strncat, strcmp, strncmp, strcpy, string(3) 

strncmp, strcpy, strncpy, strlen, string(3) 

strncpy, strlen, index, strchr, , string(3) 

strpbrk, strspn, strcspn, strtok string(3) 

strrchr, strpbrk, strspn, string(3) 

strspn, strcspn, strtok ; string . string(3) 

strtok : string operations . , string(3) 

stty, gtty : set and get terminal stty(3c) 

subroutine after a specified time ...... alarm(3f) 

subroutines store, delete, dbm(3x) 

subroutines dbm_error, ndbm(3) 

subroutines for the HP 2648 ............ Iib2648(3x) 

super-block sync(2) 

super-user( returns initgroups(3) 

supply timezone string ............... timezone(3) 

suspend execution for an interval sleep(3f) 

suspend execution for interval sleep(3) 

suspend execution for interval usleep(3) 

swab : swap bytes swab(3) 

swap bytes swab(3) 

swap device for interleaved . swapon(2) 

swapon : add a swap device for ........... swapon(2) 

symbol name for object file ldgetname(3x) 

symbol table ranhash, ranlookup ranhash(3x) 

symbol table provide a binary , . stio(3) 

symbol table stprint(3) 

symbol table entry of a common . ldtbread(3x) 

symbol table interface routines , . stcu(3) 

symbol table of a common object ldtbseek(3x) 

symbolic link readlink(2) 

symbolic link to a file ............... symlink(2) 

symlink : make symbolic link to a .......... symlink(2) 

sync : update super-block sync(2) 

synchronization of the system adjtime(2) 

synchronize a file's in-core , ; . . fsync(2) 

synchronous 1,0 multiplexing select(2) 

syscall : indirect system call syscall(2) 

sys_errlist, sys_nerr : system . . perror (3) 

syslog, openlog, closelog, syslog(3) 

sysjtierr : system error messages .......... perror(3) 

sys_siglist : system signal .............. psignal(3) 

system setmntent, addmntent, getmntent(3) 

system - ' • ■■ » mount(2) 

system setquota setquota(2) 

system unmount(2) 

system : execute a UNIX command system (3f) 

system : issue a shell command system(3) 

system call syscall(2) 

system calls siginterrupt siginterrupt(3) 

system calls and error numbers ........... intro(2) 

system clock : correct the time • . adjtime(2) 

system error messages perror(3) 

system error messages . perror(3f) 

system information uname(2) 

system log syslog, openlog, syslog(3) 

system or halt processor reboot(2) 



C 



C 
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getpagesize : get 

setrlimit : control maximum 

vlimit : control maximum 

psignal, sys_siglist : 

statfs : get file 

ctime, ltime, gmtime : return 

: runtime procedure 

: runtime procedure 

: access routine for the symbol 

interface to the MIPS symbol 

: routines to print the symbol 

ldtbread : read an indexed symbol 

provide a compilation unit symbol 

Idtbseek : seek to the symbol 

getdtablesize : get descriptor 

trigonometric sin, cos, 

sinh, cosh, 

closedir : opendir, readdir, 

data base 

for the HP 2648 graphics 

isatty, ttyslot : find name of a 

"hangup" the current control 

termcap : 

tgetflag, tgetstr, tgoto, tputs : 

ttynam, isatty : find name of a 

stty, gtty : set and get 

wait, wait3 : wait for process to 

abort : 

_exit ; 

flushing any pending exit : 

wait : wait for a process to 

tgetstr, tgoto, tputs : terminal 

terminal tgetent, tgetnum, 

tgoto, tputs : terminal tgetent, 

tgetent, tgetnum, tgetflag, 

tgetnum, tgetflag, tgetstr, 

return system time 

; get,set value of interval 

times : get process 

utime : set file 

utimes : set file 



timezone : supply 

and localtime, gmtime, asctime, 

isascii, toupper, tolower, 

popen, pclose : initiate 1,0 

iscntrl, isascii, toupper, 

isgraph, iscntrl, isascii, 

tgetflag, tgetstr, tgoto, 

ptrace : process 

filesystems mount : keep 

tan, asin, acos, at an, atan2 : 

length truncate, ftruncate : 

file to a specified length 

terminal port 

name of a terminal 

setttyent, endttyent : get 

ttyname, isatty, 

acct : 

ASCII gmtime, asctime, timezone, 

specified time 

getpw ; get name from 

mask 

fixade : fix address exceptions 

: gather statistics on 

: gather statistics on 

information 

: mark pages cacheable or 

input stream 

mktemp : make a 

gethostid, sethostid : get,set 

flush : flush output to a logical 

: reposition a file on a logical 

: get a character from a logical 



system page size getpagesize(2) 

system resource consumption getrlimit(2) 

system resource consumption vlimit(3c) 

system signal messages , psignal(3) 

system statistics statfs(2) 

system time time, time(3f) 

table _procedure_string__table . . . , end(3) 

table _procedure_string_table end(3) 

table ranhash, ranlookup ranhash(3x) 

table a binary read write stio(3) 

table stprint stprint(3) 

table entry of a common object . . ldtbread(3x) 

table interface : routines that stcu(3) 

table of a common object file ldtbseek(3x) 

table size * . . getdtablesize(2) 

tan, asin, acos, atan, atan2 : sin(3m) 

tanh : hyperbolic functions . . . . , sinh(3m) 

telldir, seekdir, rewinddir, directory (3) 

termcap : terminal capability termcap(5) 

terminal lib2648 : subroutines Iib2648(3x) 

terminal ttyname, . . ttyname(3) 

terminal vhangup : virtually vhangup(2) 

terminal capability data base termcap(5) 

terminal independent tgetnum, termcap(3x) 

terminal port ttynam(3f) 

terminal state (defunct) stty(3c) 

terminate „ . . . . wait(2) 

terminate Fortran program abort(3f) 

terminate a process exit(2) 

terminate a process after . exit(3) 

terminatesystem(3f) can not be wait(3f) 

tgetent, tgetnum, tgetflag, „ termcap(3x) 

tgetflag, tgetstr, tgoto, tputs : termcap(3x) 

tgetnum, tgetflag, tgetstr, termcap(3x) 

tgetstr, tgoto, tputs ; terminal termcap(3x) 

tgoto, tputs : terminal tgetent, termcap(3x) 

time, ctime, ltime, gmtime : time(3f) 

time, ftime : get date and time time(3c) 

timer getitimer, setitimer getitimer(2) 

times times(3c) 

times , utime(3c) 

times utimes(2) 

times : get process times times(3c) 

timezone : supply timezone string timezone(3) 

timezone string timezone(3) 

timezone, tzset : convert date ctime(3) 

toascii ; character iscntrl, ctype(3) 

to,from a process . . • popen(3) 

tolower, toascii : character . ctype(3) 

toupper, tolower, toascii : ctype(3) 

tputs : terminal independent termcap(3x) 

trace ptrace(2) 

track of remotely mounted . mount(3r) 

trigonometric functions cos, sin(3m) 

truncate a file to a specified truncate(2) 

truncate, ftruncate : truncate a . fruncate(2) 

ttynam, isatty : find name of a ttynam(3f) 

ttyname, isatty, ttyslot : find ttyname(3) 

ttys file entry getttynam, getttyent(3) 

ttyslot : find name of a terminal ttyname(3) 

turn accounting on or off acct(2) 

tzset : convert date and time to ctime(3) 

ualarm : schedule signal after ualarm(3) 

uid getpw(3c) 

umask : set file creation mode umask(2) 

(unaligned references) fixade(2) 

unaligned references unaligned(3) 

unaligned references unaligned(3) 

uname : get general system uname(2) 

uncacheable cachectl cachectl(2) 

ungetc : push character back into ungetc(3s) 

unique file name , mktemp(3) 

unique identifier of current host gethostid(2) 

unit . flush(3f) 

unit fseek, ftell fseek(3f) 

unit getc, fgetc getc(3f) 
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and dissabling the floating-point 

a character to a fortran logical 

that provide a compilation 



mmap, munmap : map or 

environmental getenv, setenv, 

pause : stop 

sync : 

pages yppasswd : 

setreuid : set real and effective 

setgid, setegid, setrgid : set 

getuid, geteuid : get 

getuid, getgid : get 

yppasswd : update 

endusershell : get legal 

getlog : get 

r users : return information about 

interval 

: get information about resource 

: get information about resource 



abs : integer absolute 

distance, complex absolute 

floor, ceil, rint : absolute 

readlink : read 

getenv : get 

getitimer, setitimer : get, set 

: classes of IEEE floating-point 

: classes of IEEE floating-point 

htons, ntohl, ntohs : convert 

varargs : 

: manipulate environmental 

getenv : get value of environment 

library packages 

assert : program 

virtual memory efficient way 

the current control terminal 

vfork : spawn new process in a 

control terminal vhangup : 

resource consumption 

resource utilization 

terminatesystem(3f) can not h& 

terminatesystem(3f) can wait : 

release blocked signals and 

wait, wait3 : 

terminate 

terminate wait, 

fgetc, getw : get character or 

fputc, putw : put character or 

chdir : change current 

getcwd : get pathname of current 

getwd : get current 

logical unit putc, fputc : 

that provide a binary read 

write, writev : 

machines rwall : 

write, 

open : open a file for reading or 

: public domain packages 

external data representation 

JO, jl, jn, 

JO, jl, jn, yO, 

: update user password in 

yperr_string, ypprot_err : 

jO, jl, jn, yO, yl, 

yp_match, yp_nrst, yp_next, 

ypclnt, yp„get_default__domain, 

yp_bind, yp_unbind, yp_xnatch, 

yp_all, yp_order, yp_master, 

yp_bind, yp_unbind, ypjnatch, 



unit mipsfpu : enabling mipsfpu(2) 

unit putc, fputc : write . .' putc(3f) 

unit symbol table interface * . stcu(3) 

unlink : remove a directory entry .......... unlink(3f) 

unlink : remove directory entry unlink(2) 

unmap pages of memory mmap(2) 

unmount : remove a file system unmount(2) 

unsetenv : manipulate . getenv(3) 

until signal pause(3c) 

update super-block sync(2) 

update user password in yellow , yppasswd(3r) 

user ID's setreuid(2) 

user and group ID setruid, ............. setuid(3) 

user identity ' . . getuid(2) 

user or group ID of the caller getuid(3f) 

user password in yellow pages . . .• yppasswd(3r) 

user shells setusershell, getusershell(3) 

user's login name » , getlog(3f) 

users on remote machines rnusers(3r) 

usleep : suspend execution for . . usleep(3) 

utilization getrusage getrusage(2) 

utilization vtimes ,....,.,..., vtimes(3c) 

utime : set file times . . utime(3c) 

utimes : set file times . utimes(2) 

valloc : aligned memory allocator valloc(3c) 

value abs(3) 

value hypot, cabs : Euclidean hypot(3m) 

value, floor, ceiling, and fabs, floor(3m) 

value of a symbolic link ............... readlink(2) 

value of environment variables ......,..•• getenv(3f) 

value of interval timer . . getitimer(2) 

values fp^class fp_class(3) 

values fp_class ............. fp_class(3) 

values between host and network byteorder(3n) 

varargs : variable argument list • , varargs(3) 

variable argument list varargs(3) 

variables setenv, unsetenv «... getenv(3) 

variables .,..,......, getenv(3f) 

verdixlib : MIPS -supported Ada . . , verdixlib(3) 

verification . . assert(3) 

vfork : spawn new process in a • vfork(2) 

vhangup : virtually "hangup" , vhangup(2) 

virtual memory efficient way vfork(2) 

virtually "hangup" the current vhangup(2) 

vlimit : control maximum system vlimit(3c) 

vtimes : get information about vtimes(3c) 

wait : wait for a process to wait(3f) 

wait for a process to wait(3f) 

wait for interrupt : atomically . sigpause(2) 

wait for process to terminate . wait(2) 

wait, wait3 ; wait for process to wait(2) 

wait3 : wait for process to wait(2) 

word from stream getc, getchar, getc(3s) 

word on a stream putc, putchar, putc(3s) 

working directory chdir(2) 

working directory . . getcwd(3f) 

working directory pathname getwd(3) 

write a character to a fortran putc(3f) 

write interface to the MIPS • stio(3) 

write output write(2) 

write to specified remote rwall(3r) 

write, writev : write output write(2) 

writev : write output write(2) 

writing, or create a new file open(2) 

written in Ada publiclib . publiclib(3) 

xdr : library routines for xdr(3n) 

yO, yl, yn : bessel functions j0(3m) 

yl, yn : bessel functions .............. j0(3m) 

yellow pages yppasswd , . . . yppasswd(3r) 

yellow pages client interface ypclnt(3n) 

yn : bessel functions j0(3m) 

yp„all, yp^order, yp^m aster, ypelnt(3n) 

yp^bind, yp_unbind, yp_match, ypclnt(3n) 

ypclnt, yp_get_defaulUdomain, ypclnt(3n) 

yperr^string, ypprot_err ; yellow . ypclnt(3n) 

yp_first a yp^next, yp_all, . f ypclnt(3n) 
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yp_unbind, yp_match, ypclnt, yp_get_default_domain, yp_bind, . . , ypclnt(3n) 

yp_next, yp_all, yp_order, yp_jnaster, yperr_string, ypclnt(3n) 

yp_all, yp_bind, yp_unbind, yp_match, ypjfirst, yp_next, ypclnt(3n) 

yp__unbind, yp_match, yp_first, yp_next, yp_all, yp_order, ypclnt(3n) 

ypjSrst, ypjiext, yp_all, yp_order, yp_master, yp_match, ypclnt(3n) 

in yellow pages yppasswd : update user password . yppasswd(3r) 

yp_m aster, yperr_string, ypprot_err : yellow pages client ypclnt(3n) 

yp_get_default_.domain, yp_bind, yp_unbind, yp_jnatch, ypjfirst, ypclnt(3n) 
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NAME 

accept - accept a connection on a socket 

SYNOPSIS 

#include <sys/types.h> 
#inc!ude <sys/socket.h> 

ns = accept(s, addr, addrlen) 

int ns 5 s; 

struct sockaddr *addr; 

int *addrkn; 

DESCRIPTION 

The argument s is a socket that has been created with socket(2), bound to an address with 
bind {2), and is listening for connections after a listen (2). accept extracts the first connection 
on the queue of pending connections, creates a new socket with the same properties of s and 
allocates a new file descriptor, ns, for the socket. If no pending connections are present on 
the queue, and the socket is not marked as non-blocking, accept blocks the caller until a con- 
nection is present. If the socket is marked non-blocking and no pending connections are 
present on the queue, accept returns an error as described below. The accepted socket, ns, 
may not be used to accept more connections. The original socket s remains open. 

The argument addr is a result parameter that is filled in with the address of the connecting 
entity, as known to the communications layer. The exact format of the addr parameter is 
determined by the domain in which the communication is occurring. The addrlen is a value- 
result parameter; it should initially contain the amount of space pointed to by addr; on return 
it will contain the actual length (in bytes) of the address returned. This call is used with 
connection-based socket types, currently with SOCK_STREAM. 

It is possible to select (2) a socket for the purposes of doing an accept by selecting it for read. 

RETURN VALUE 

The call returns -1 on error. If it succeeds, it returns a non-negative integer that is a descrip- 
tor for the accepted socket. 

ERRORS 

The accept will fail if: 

[EBADF] The descriptor is invalid. 

[ENOTSOCK] The descriptor references a file, not a socket. 

[EOPNOTSUPP] The referenced socket is not of type SOCKLSTREAM. 

[EFAULT] The addr parameter is not in a writable part of the user address space. 

[EWOULDBLOCK] The socket is marked non-blocking and no connections are present to 
be accepted. 

SEE ALSO 

bind(2), connect(2), listen(2), select (2), socket(2) 
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NAME 



access - determine accessibility of file 



SYNOPSIS 

#include <$y$/file.h> 



#define R„OK 
#define W_OK 
#define X^OK 
#define F_J)K 



4 /* test for read permission */ 

2 /* test for write permission */ 

1 /* test for execute (search) permission */ 

/* test for presence of file */ 

accessible ss access(path, mode) 
int accessible; 
char *path; 
int mode; 

DESCRIPTION 

access checks the given file path for accessibility according to mode, which is an inclusive or 
of the bits R_OK, W_QK and XL.OK. Specifying mode as FJ3K (i.e., 0) tests whether the direc- 
tories leading to the file can be searched and the file exists. 

The real user -slID and the group access list (including the real group -slID) are 
used in verifying. permission, so this call is useful to set-UID programs. 

Notice. that only access bits are checked, A directory may be indicated as writable by access, 
but an attempt to open it for writing will fail (although files may be created there); a file may 
look executable, but execve will fail unless it is in proper format. 

RETURN VALUE 

If path cannot be found or if any of the desired access modes would not be granted, then a -1 
value is returned; otherwise a value is returned. 



ERRORS 



Access to the file is denied if one or more of the following are true; 



[ENOTDIR] 

[EINVAL] 

[ENAMETOOLONG] 

[ENOENT] 
[EACCES] 
[ELOOP] 

[EROFS] 
[ETXTBSY] 

[EACCES] 



[EFAULT] 



A component of the path prefix is not a directory. 

The pathname contains a character with the high-order bit set. 

A component of a pathname exceeded 255 characters, or an entire 
path name exceeded 1023 characters. 

The named file does not exist. 

Search permission is denied for a component of the path prefix. 

Too many symbolic links were encountered in translating the path- 
name. 

Write access is requested for a file on a read-only file system. 

Write access is requested for a pure procedure (shared text) file 
that is being executed. 

Permission bits of the file mode do not permit the requested 
access, or search permission is denied on a component of the path 
prefix. The owner of a file has permission checked with respect to 
the "owner" read, write, and execute mode bits, members of the 
file ? s group other than the owner have permission checked with 
respect to the "group" mode bits, and all others have permissions 
checked with respect to the "other" mode bits. 

path points outside the process's allocated address space. 
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[EIO] An I/O error occurred while reading from or writing to the file sys- 

tem. 

SEE ALSO 

chmod(2), stat(2) 
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NAME 

acct - turn accounting on or off 

SYNOPSIS 

acct(file) 
ch^r *file; 

DESCRIPTION 

The system is prepared to write a record in an accounting file for each process as it ter- 
minates. This call, with a null4erminated string naming an existing file as argument, turns on 
accounting; records for each terminating process are appended to file. An argument of 
causes accounting to be turned off , 

The accounting file format is given in met (5), 

This call is permitted only to the super-user. 

NOTES 

Accounting is automatically disabled when the file system the accounting file resides on runs 
out of space; it is enabled when space oucq again becomes available. 

RETURN VALUE 

On error -1 is returned. The file must exist and the call may be exercised only by the super- 
user. It is erroneous to try to turn on accounting when it is already on. 

ERRORS 

acct will fail if one of the following is true: 

[EPERM] The caller is not the super-user. 

[ENOTDIR] A component of the path prefix is not a directory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an entire 

path name exceeded 1023 characters. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path prefix, or 

the path name is not a regular file. 

[ELOOP] Too many symbolic links were encountered in translating the path- 

name. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] file points outside the process's allocated address space, 

[EIO] An I/O error occurred while reading from or writing to the file sys- 

tem. 

SEE ALSO 

acct(5), sa(8) 

WARNING 

No accounting is produced for programs running when a crash occurs. In particular non- 
terminating programs are never accounted for. 
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NAME 

adjtime - correct the time to allow synchronization of the system clock 

SYNOPSIS 

#include <sys/time.h> 

adjtime (delta, olddelta) 
struct timeval *delta; 
struct timeval *olddelta; - 

DESCRIPTION 

adjtime makes small adjustments to the system time, as returned by gettimeof day (2), advanc- 
ing or retarding it by the time specified by the timeval delta. If delta is negative, the clock is 
slowed down by incrementing it more slowly than normal until the correction is complete. If 
delta is positive, a larger increment than normal is used. The skew used to perform the 
correction is generally a fraction of one percent. Thus, the time is always a monotonically 
increasing function. A time correction from an earlier call to adjtime may not be finished 
when adjtime is called again. If olddelta is non-zero, then the structure pointed to will con- 
tain, upon return, the number of microseconds still to be corrected from the earlier call. 

This call may be used by time servers that synchronize the clocks of computers in a local area 
network. Such time servers would slow down the clocks of some machines and speed up the 
clocks of others to bring them to the average network time. 

The call adjtime(2) is restricted to the super-user. 

RETURN VALUE 

A return value of indicates that the call succeeded. A return value of -1 indicates that an 
error occurred, and in this case an error code is stored in the global variable errno. 

ERRORS 

The following error codes may be set in errno: 

[EFAULT] An argument points outside the process's allocated address space. 

[EPERM] The process's effective user ID is not that of the super-user. 

SEE ALSO 

date(l), gettimeofday(2), timed(8), timedc(8), 

TSP: The Time Synchronization Protocol for UNIX x4.3BSD, R. Gusella and S. Zatti 
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NAME 

bind - bind a name to a socket 

SYNOPSIS 

#include <sys/types,h> 
#include <sys/socket,h> 

bitid(s 9 name, namelen) 
int s; 

struct swkaddr »name; 
int namelen; 

DESCRIPTION 

bind assigns a name to an unnamed socket. When a socket is created with socket (2) it exists 
in a name space (address family) but has no name assigned, bind requests that name be 
assigned to the socket. 

NOTES 

Binding a name in the UNIX domain creates a socket in the file system that must be deleted by 
the caller when it is no longer needed (using unlink (2)). 

The rules used in name binding vary between communication domains. Consult the manual 
entries in section 4 for detailed information. 

RETURN VALUE 

If the bind is successful, a value is returned. A return value of -1 indicates an error, which 
is further specified in the global errno. 

ERRORS 

The bind call will fail if: 



[EBADF] 
[ENOTSOCK] 
[EADDRNOTAVAIL] 
[EADDRINUSE] 

[EINVAL] 
[EACCES] 



s is not a valid descriptor. 

S is not a socket. 

The specified address is not available from the local machine. 

The specified address is already in use. 

The socket is already bound to an address. 

The requested address is protected, and the current user has inade- 
quate permission to access it. 

[EFAULT] The name parameter is not in a valid part of the user address 

space. 

The following errors are specific to binding names in the UNIX domain. 



[ENOTDIR] 

[EINVAL] 

[ENAMETOOLONG] 

[ENOENT] 
[ELOOP] 

[EIO] 

[EROFS] 
[EISDIR] 



A component of the path prefix is not a directory. 

The pathname contains a character with the high-order bit set. 

A component of a pathname exceeded 255 characters, or an entire 
path name exceeded 1023 characters. 

A prefix component of the path name does not exist. 

Too many symbolic links were encountered in translating the path- 
name. 

An I/O error occurred while making the directory entry or allocat- 
ing the inode. 

The name would reside on a read-only file system. 

A null pathname was specified. 
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SEE ALSO 

connect(2), listen(2), socket(2), getsockname(2) 
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NAME 

brk, sbrk - change data segment size 

SYNOPSIS 

#include <sys/types.h> 

char *fork(addr) 
char *addr; 

char *sbrk(incr) 
int incr; 

DESCRIPTION 

brk sets the system's idea of the lowest data segment location not used by the program (called 
the break) to addr (rounded up to the next multiple of the system's page size). Locations 
greater than addr and below the stack pointer are not in the address space and will thus cause 
a memory violation if accessed. 

In the alternate function sbrk ? incr more bytes are added to the program's data space and a 
pointer to the start of the new area is returned. 

When a program begins execution via execve the break is set at the highest location defined by 
the program and data storage areas. Ordinarily, therefore, only programs with growing data 
areas need to use sbrk 

The getrlimit(2) system call may be used to determine the maximum permissible size of the 
data segment; it will not be possible to set the break beyond the rlimjnax value returned from 
a call to getrlimit, e.g. u etext + rlp-~>rlim_jnax." (see end(3) for the definition of etext). 

RETURN VALUE 

Zero is returned if the brk could be set; -1 if the program requests more memory than the sys- 
tem limit, sbrk returns -1 if the break could not be set. 

ERRORS 

sbrk will fail and no additional memory will be allocated if one of the following are true: 

[ENOMEM] The limit, as set by setrlimit(2), was exceeded. 

[ENOMEM] The maximum possible size of a data segment (compiled into the sys- 

tem) was exceeded. 

[ENOMEM] Insufficient space existed in the swap area to support the expansion. 

SEE ALSO 

execve(2), getrlimit(2), malloc(3), end(3) 

WARNING 

Setting the break may fail due to a temporary lack of swap space. It is not possible to distin- 
guish this from a failure caused by exceeding the maximum size of the data segment without 
consulting getrlimit. 



( 
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NAME 

cachectl - mark pages cacheable or uncacheable 

SYNOPSIS 

#in elude <mips/cachectl.h> 

cachectl (addr, nbytes, op) 
char *addr; 
int nbytes, op; 

DESCRIPTION 

The cachectl system call allows a process to make ranges of its address space cacheable or 
uncacheable. Initially, a process's entire address space is cacheable. 

op may be one of; 

CACHEABLE Make the indicated pages cacheable 

UNCACHEABLE Make the indicated pages uncacheable 

The CACHEABLE and UNCACHEABLE op's affect the address range indicated by addr and 
nbytes. addr must be page aligned and nbytes must be a multiple of the page size. 

Changing a page from UNCACHEABLE state to CACHEABLE state will cause both the 
instruction and data caches to be flushed if necessary to avoid stale cache information. 

RETURN VALUE 

cached returns when no errors are detected. If errors are detected, cachectl returns -1 with 
the error cause indicated in errno. 

ERRORS 

[EINVAL] op parameter is not one of CACHEABLE or UNCACHEABLE. 

[EINVAL] addr is not page aligned, or nbytes is not multiple of pagesize. 

[EFAULT] Some or all of the address range addr to (addr+nbyte$-l) is not access- 

able. 

SEE ALSO 

getpagesize(2) 
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NAME I 

cacheflush - flush contents of instruction and/or data cache ^ 

SYNOPSIS 

#include <mips/cachectLh> 

cacheflush (addr, nbytes, cache) 

char *addr; 

int mbytes, cache; 

DESCRIPTION 

Flushes contents of indicated cache(s) for user addresses in the range addr to (addr+nhytes-l). 
cache may be one of: 

ICACHE Flush only the instruction cache 

DCACHE Flush only the data cache 

BCACHE Flush both instruction and data caches 

RETURN VALUE 

cacheflush returns when no errors are detected. If errors are detected, cacheflush returns -1 
with the error cause indicated in errno* 

ERRORS 

[EINVAL] cache parameter is not one of ICACHE, DCACHE, or BCACHE. 

[EFAULT] Some or all of the address range addr to (addr+nbytes-1) is not access- 

able. 
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NAME 

chdir - change current working directory 

SYNOPSIS 

chdir(path) 
char *path; 

DESCRIPTION 

path is the pathname of a directory, chdir causes this directory to become the current working 
directory, the starting point for path names not beginning with "/". 

In order for a directory to become the current directory, a process must have execute (search) 
access to the directory. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

ERRORS 

chdir will fail and the current working directory will be unchanged if one or more of the fol- 
lowing are true: 



[ENOTDIR] 

[EINVAL] 
[ENAMETOOLONG] 

[ENOENT] 
[ELOOP] 



[EACCES] 
[EFAULT] 
[EIO] 

SEE ALSO 

chroot(2) 



A component of the path prefix is not a directory. 

The pathname contains a character with the high-order bit set. 

A component of a pathname exceeded 255 characters, or an entire 
path name exceeded 1023 characters. 

The named directory does not exist. 

Too many symbolic links were encountered in translating the path- 
name. 

Search permission is denied for any component of the path name. 

path points outside the process's allocated address space. 

An I/O error occurred while reading from or writing to the file sys- 
tem. 
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NAME 

chmod - change mode of file 

SYNOPSIS 

chmod (path, mode) 
char *path; 
int mode; 

fchmod(fd ? mode) 
int fd 9 mode; 

DESCRIPTION 

The file whose name is given by path or referenced by the descriptor fd has its mode changed 
to mode. Modes are constructed by or'ing together some combination of the following, 
defined in <syslinode.h> : 

XSUXD 04000 set user ID on execution 

ISGID 02000 set group ED on execution 

ISVTX 01000 'sticky bit' (see below) 

IRE AD 00400 read by owner 

IWRITE 00200 write by owner 

IEXEC 00100 execute (search on directory) by owner 

00070 read, write, execute (search) by group 

00007 read, write, execute (search) by others 

K an executable file is set up for sharing (this is the default) then mode ISVTX (the 'sticky 
bit') prevents the system from abandoning the swap-space image of the program-text portion 
of the file when its last user terminates, Ability to set this bit on executable files is restricted 
to the super-user. 

If mode ISVTX (the 'sticky bif) is set on a directory, an unprivileged user may not delete or 
rename files of other users in that directory. For more details of the properties of the sticky 
bit, see sticky (8). 

Only the owner of a file (or the super-user) may change the mode. 

Writing or changing the owner of a file turns off the set-user-id and set-group-id bits unless the 
user is the super-user. This makes the system somewhat more secure by protecting set-user-id 
(set-group-id) files from remaining set-user-id (set-group-id) if they are modified, at the expense 
of a degree of compatibility. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

ERRORS 

Chmod will fail and the file mode will be unchanged if: 

[ENOTDIR] A component of the path prefix is not a directory. 
[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] 

A component of a pathname exceeded 255 characters, or an entire path name 
exceeded 1023 characters. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EPERM] The effective user ID does not match the owner of the file and the effective 
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user ED is not the super-user. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points outside the process's allocated address space. 

[EIO] An I/O error occurred while reading from or writing to the file system. 

Fchmod will fail if: 

[EBADF] The descriptor is not valid. 

[EINVAL] Fd refers to a socket, not to a file. 

[EROFS] The file resides on a read-only file system. 

[EIO] An I/O error occurred while reading from or writing to the file system. 

SEE ALSO 

chmod(l), open(2), chown(2), stat(2), sticky(8) 
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NAME 

chown - change owner and group of a file 

SYNOPSIS 

chown(path 9 owner, group) 

char *path; 

int owner, group; 

fchown (fd, owner, group) 
int fd, owner, group; 

DESCRIPTION 

The file that is named by path or referenced by fd has its owner and group changed as 
specified. Only the super-user may change the owner of the file, because if users were able to 
give files away, they could defeat the file-space accounting procedures. The owner of the file 
may change the group to a group of which he is a member. 

On some systems, chown clears the set-user-id and set-group-id bits on the file to prevent 
accidental creation of set-user-id and set-group-id programs. 

fchown is particularly useful when used in conjunction with the file locking primitives (see 
flock (2)). 

One of the owner or group id's may be left unchanged by specifying it as -1. 

If the final component of path is a symbolic link, the ownership and group of the symbolic 
link is changed, not the ownership and group of the file or directory to which it points. 

RETURN VALUE 

Zero is returned if the operation was successful; -1 is returned if an error occurs, with a more 
specific error code being placed in the global variable errno* 

ERRORS 

chown will fail and the file will be unchanged if: 



[ENOTDIR] 

[EINVAL] 

[ENAMETOOLONG] 

[ENOENT] 
[EACCES] 
[ELOOP] 

[EPERM] 
[EROFS] 
[EFAULT] 
[EIO] 

fchown will fail if: 

[EBADF] 

[EINVAL] 

[EPERM] 

[EROFS] 



A component of the path prefix is not a directory. 

The pathname contains a character with the high-order bit set. 

A component of a pathname exceeded 255 characters, or an entire 
path name exceeded 1023 characters. 

The named file does not exist. 

Search permission is denied for a component of the path prefix. 

Too many symbolic links were encountered in translating the path- 
name. 

The effective user ID is not the super-user. 

The named file resides on a read-only file system. 

path points outside the process's allocated address space. 

An I/O error occurred while reading from or writing to the file sys- 
tem. 

fd does not refer to a valid descriptor. 

fd refers to a socket, not a file. 

The effective user ID is not the super-user. 

The named file resides on a read-only file system. 
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[EIO] An I/O error occurred while reading from or writing to the file sys- 

tem. 

SEE ALSO 

chown(8) ? chgrp(l), chmod(2), flock(2) 
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NAME 

close - delete a descriptor 

SYNOPSIS 

close (d) 
int d; 

DESCRIPTION 

The close call deletes a descriptor from the per-process object reference table. If this is the 
last reference to the underlying object, then it will be deactivated. For example, on the last 
close of a file the current seek pointer associated with the file is lost; on the last close of a 
socket (2) associated naming information and queued data are discarded; on the last close of a 
file holding an advisory lock the lock is released (see further flock (2)). 

A close of all of a process's descriptors is automatic on exit, but since there is a limit on the 
number of active descriptors per process, close is necessary for programs that deal with many 
descriptors. 

When a process forks (see fork(2)), all descriptors for the new child process reference the 
same objects as they did in the parent before the fork. If a new process is then to be ran 
using execve (2), the process would normally inherit these descriptors. Most of the descriptors 
can be rearranged with dup2(2) or deleted with close before the execve is attempted, but if 
some of these descriptors will still be needed if the execve fails, it is necessary to arrange for 
them to. be closed if the execve succeeds. For this reason, the call fcntil(d, F_SETFD, 1) is pro- 
vided, which arranges that a descriptor will be closed after a successful execve; the call 
fentl(d 9 F_SETFD 9 0) restores the default, which is to not close the descriptor. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned 
and the global integer variable errno is set to indicate the error. 

ERRORS 

close will fail if: 

[EBADF] d is not an active descriptor. 

SEE ALSO 

accept(2), flock(2), open(2), pipe(2), socket(2), socketpair(2), execve(2), fcntl(2) 
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NAME 

connect - initiate a connection on a socket 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/socket.h> 

connect(s, name, namelen) 
int s; 

struct sockaddr *name; 
int nameien; 

DESCRIPTION 

The parameter s is a socket. If it is of type SOCELDGRAM, then this call specifies the peer 
with which the socket is to be associated; this address is that to which datagrams are to be 
sent, and the only address from which datagrams are to be received. If the socket is of type 
SOCK_STREAM, then this call attempts to make a connection to another socket. The other 
socket is specified by name, which is an address in the communications space of the socket. 
Each communications space interprets the name parameter in its own way. Generally, stream 
sockets may successfully connect only once; datagram sockets may use connect multiple times 
to change their association. Datagram sockets may dissolve the association by connecting to 
an invalid address, such as a null address. 

• RETURN VALUE 

If the connection or binding succeeds, then is returned. Otherwise a -1 is returned, and a 
more specific error code is stored in errno. 

ERRORS 

The call fails if: 

[EBADF] s is not a valid descriptor. 

[ENOTSOCK] s is a descriptor for a file, not a socket. 

[EADDRNOTAVAIL] The specified address is not available on this machine. 

[EAFNO SUPPORT] Addresses in the specified address family cannot be used with this 

socket. 

[EISCONN] The socket is already connected. 

[ETIMEDOUT] Connection establishment timed out without establishing a connec- 

tion. 

[ECONNREFUSED] The attempt to connect was forcefully rejected. 

[ENETUNREACH] The network isn't reachable from this host, 

[EADDRINUSE] The address is already in use. 

[EFAULT] The name parameter specifies an area outside the process address 

space. 

[EINPROGRESS] The socket is non-blocking and the connection cannot be com- 

pleted immediately. It is possible to select(2) for completion by 
selecting the socket for writing. 

[EALREADY] The socket is non-blocking and a previous connection attempt has 

not yet been completed. 

The following errors are specific to connecting names in the UNIX domain. These errors may 
not apply in future versions of the UNIX IPC domain. 

[ENOTDIR] A component of the path prefix is not a directory. 
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[EINVAL] 
[ENAMETOOLONG] 

[ENOENT] 
[EACCES] 
[EACCES] 
[ELOOP] 



The pathname contains a character with the high-order bit set. 

A component of a pathname exceeded 255 characters, or an entire 
path name exceeded 1023 characters. 

The named socket does not exist. 

Search permission is denied for a component of the path prefix. 

Write access to the named socket is denied. 

Too many symbolic links were encountered in translating the path- 
name. 



( 



SEE ALSO 



accept(2), select(2) ? socket(2) ? getsockname(2) 
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NAME 



creat - create a new file 



SYNOPSIS 

creat(name, mode) 
char *name; 

DESCRIPTION 

This interface is made obsolete by open (2). 

creat creates a new file or prepares to rewrite an existing file called name, given as the address 
of a null-terminated string. If the file did not exist, it is given mode mode, as modified by the 
process's mode mask (see umask(2)). Also see chmod(2) for the construction of the mode 
argument. 

If the file did exist, its mode and owner remain unchanged but it is truncated to length. 

The file is also opened for writing, and its file descriptor is returned. 

NOTES 

The mode given is arbitrary; it need not allow writing. This feature has been used in the past 
by programs to construct a simple, exclusive locking mechanism. It is replaced by the 
0_EXCL open mode, or flock (2) facility. 

RETURN VALUE 

The value -1 is returned if an error occurs. Otherwise, the call returns a non-negative descrip- 
tor that only permits writing. 

ERRORS 

creat will fail and the file will not be created or truncated if one of the following occur: 



[ENOTDIR] 

[EINVAL] 
[ENAMETOOLONG] 

[ENOENT] 
[ELOOP] 

[EACCES] 
[EACCES] 

[EACCES] 

[EISDIR] 

[EMFILE] 

[ENFILE] 

[ENOSPC] 

[ENOSPC] 
[EDQUOT] 



A component of the path prefix is not a directory. 

The pathname contains a character with the high-order bit set. 

A component of a pathname exceeded 255 characters, or an entire 
path name exceeded 1023 characters. 

The named file does not exist. 

Too many symbolic links were encountered in translating the path- 
name. 

Search permission is denied for a component of the path prefix. 

The file does not exist and the directory in which it is to be created 
is not writable. 

The file exists, but it is unwritable. 

The file is a directory. 

There are already too many files open. 

The system file table is full. 

The directory in which the entry for the new file is being placed 
cannot be extended because there is no space left on the file sys- 
tem containing the directory. 

There are no free inodes on the file system on which the file is 
being created. 

The directory in which the entry for the new file is being placed 
cannot be extended because the user's quota of disk blocks on the 
file system containing the directory has been exhausted. 
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[EDQUOT] 

[EROFS] 

[ENXIO] 

[ETXTBSY] 

[EIO] 

[EFAULT] 
[EOPNOTSUPP] 

SEE ALSO 



The user's quota of inodes on the file system on which the file is 
being created has been exhausted. 

The named file resides on a read-only file system. 

The file is a character special or block special file, and the associ- 
ated device does not exist. 

The file is a pure procedure (shared text) file that is being exe- 
cuted. 

An I/O error occurred while making the directory entry or allocat- 
ing the inode. 

name points outside the process's allocated address space. 

The file was a socket (not currently implemented). 



c 



open(2), write(2) ? close(2)> chmod(2) ? umask(2) 
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NAME 

dup, dup2 - duplicate a descriptor 

SYNOPSIS 

newd ss dup(oldd) 

let newd, oldd; 

dup2(oldd 9 newd) 
int oldd, newd; 

DESCRIPTION 

dup duplicates an existing object descriptor. The argument oldd is a small non-negative 
integer index in the per-process descriptor table. The value must be less than the size of the 
table, which is returned by getdtablesize(2). The new descriptor returned by the call, newd, is 
the lowest numbered descriptor that is not currently in use by the process. 

The object referenced by the descriptor does not distinguish between references using oldd 
and newd in any way. Thus if newd and oldd are duplicate references to an open file, read{2)> 
write (2) and lseek(2) calls all move a single pointer into the file, and append mode, non- 
blocking I/O and asynchronous I/O options are shared between the references. If a separate 
pointer into the file is desired, a different object reference to the file must be obtained by issu- 
ing an additional open(2) call. The close-on-exec flag on the new file descriptor is unset. 

In the second form of the call, the value of newd desired is specified. If this descriptor is 
already in use, the descriptor is first deallocated as if a dose (2). call had been done first. 

RETURN VALUE 

The value -1 is returned if an error occurs in either call. The external variable errno indicates 
the cause of the error. 

ERRORS 

dup and dup2 fail if: 

[EBADF] oldd or newd is not a valid active descriptor 

[EMFILE] Too many descriptors are active. 

SEE ALSO 

accept(2), open(2), close(2), fcntl(2), pipe(2), socket(2), socketpair(2), getdtablesize(2) 
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NAME 

execve - execute a file 

SYNOPSIS 

execve (name, argv, envp) 
char *name, *argv[]? *enypQ; 

DESCRIPTION 

execve transforms the calling process into a new process. The new process is constructed 
from an ordinary file called the new process file. This file is either an executable object file, or 
a file of data for an interpreter. An executable object file consists of an identifying header, 
followed by pages of data representing the initial program (text) and initialized data pages. 
Additional pages may be specified by the header to be initialized with zero data. See a.out(5). 

An interpreter file begins with a line of the form u #\ interpreter". When an interpreter file is 
execve ? d, the system execve ? s the specified interpreter, giving it the name of the originally 
exec'd file as an argument and shifting over the rest of the original arguments. 

There can be no return from a successful execve because the calling core image is lost. This is 
the mechanism whereby different process images become active. 

The argument argv is a null-terminated array of character pointers to null-terminated character 
strings. These strings constitute the argument list to be made available to the new process. 
By convention, at least one argument must be present in this array, and the first element of 
this array should be the name of the executed program (i.e., the last component of name). 

The argument envp is also a null-terminated array of character pointers to null-terminated 

strings. These strings pass information to the new process that is not directly an argument to 
the command (see environ(7)). 

Descriptors open in the calling process remain open in the new process, except for those for • I 

which the close-ori-exec flag is set (see close (2)). Descriptors that remain open are unaffected 

by execve . 

Ignored signals remain ignored across an execve, but signals that are caught are reset to their 
default values. Blocked signals remain blocked regardless of changes to the signal action. 
The signal stack is reset to be undefined (see sigvec(2) for more information). 

Each process has real user and group IDs and an effective user and group IDs. The real ID 
identifies the person using the system; the effective ID determines his access privileges, execve 
changes the effective user and group ID to the owner of the executed file if the file has the 
" set-user-ID 9 ? or u set-group-ID ?? modes. The real user ID is not affected. 

The new process also inherits the following attributes from the calling process: 

process ID see getpid (2) 

parent process ID see getppid (2) 

process group ID see getpgrp (2) 

access groups see getgroups (2) 

working directory see chdir (2) 

root directory see chroot (2) 

control terminal see tty (4) 

resource usages see getrusage (2) 

. interval timers see getitimer (2) 

resource limits see getrlimit (2) 

file mode mask see umask (2) 

signal mask see sigvec (2), sigmask (2) 



( 
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When the executed program begins, it is called as follows: 

main(argc, argv, envp) 

int argc; 

char **argv, **envp; 

where argc is the number of elements in argv (the "arg count") and argv is the array of charac- 
ter pointers to the arguments themselves. 

envp is a pointer to an array of strings that constitute the environment of the process. A 
pointer to this array is also stored in the global variable "environ". Each string consists of a 
name, an "-", and a null-terminated value. The array of pointers is terminated by a null 
pointer. The shell sh(l) passes an environment entry for each global shell variable defined 
when the program is called. See environ (7) for some conventionally used names. 

RETURN VALUE 

If execve returns to the calling process an error has occurred; the return value will be -1 and 
the global variable errno will contain an error code. 

ERRORS 

execve will fail and return to the calling process if one or more of the following are true: 



[ENOTDIR] 

[EINVAL] 

[ENAMETOOLONG] 

[ENOENT] 
[ELOOP] 

[EACCES] 
[EACCES] 
[EACCES] 
[ENOEXEC] 

[ETXTBSY] 

[ENOMEM] 

[E2BIG] 

[EFAULT] 



A component of the path prefix is not a directory. 

The pathname contains a character with the high-order bit set. 

A component of a pathname exceeded 255 characters, or an entire 
path name exceeded 1023 characters. 

The new process file does not exist. 

Too many symbolic links were encountered in translating the path- 
name. 

Search permission is denied for a component of the path prefix. 

The new process file is not an ordinary file. 

The new process file mode denies execute permission. 

The new process file has the appropriate access permission, but 
has an invalid magic number in its header. 

The new process file is a pure procedure (shared text) file that is 
currently open for writing or reading by some process. 

The new process requires more virtual memory than is allowed by 
the imposed maximum (getrlimit(2)). 

The number of bytes in the new process's argument list is larger 
than the system-imposed limit. The limit in the system as released 
is 20480 bytes (NCARGS) in <sys/param.h> . 

The new process file is not as long as indicated by the size values 
in its header. 



path , argv , or envp point to an illegal address. 

An I/O error occurred while reading from the file system. 



[EFAULT] 
[EIO] 

CAVEATS 

If a program is setuid to a non-super-user, but is executed when the real aid is "root", then 
the program has some of the powers of a super-user as well. 
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SEE ALSO 

exit(2), fork(2) ? execl(3), environ(T) 



( 



( 



MIPS Computer Systems, Inc. February 5, 1989 Page 3 



EXIT ( 2-BSD ) RISC/os Programmer's Reference EXIT ( 2-BSD ) 



NAME 

_exit - terminate a process 

SYNOPSIS 

_exit (status) 
int status; 

DESCRIPTION 

_exit terminates a process with the following consequences: 

All of the descriptors open in the calling process are closed. This may entail delays, for 
example, waiting for output to drain; a process in this state may not be killed, as it is already 
dying. 

If the parent process of the calling process is executing a wait or is interested in the SIGCHLD 
signal, then it is notified of the calling process's termination and the low-order eight bits of 
status are made available to it; see wait (2). 

The parent process ID of all of the calling process's existing child processes are also set to 1. 
This means that the initialization process (see intro(2)) inherits each of these processes as 
well. Any stopped children are restarted with a hangup signal (SIGHUP). 

Most C programs call the library routine exit (3), which performs cleanup actions in the stan- 
dard I/O library before calling _exit . 

RETURN VALUE 

This call never returns. 

SEE ALSO 

fork(2), sigvec(2), wait(2), exit(3) 
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NAME 



fcntl - file control 



( 



SYNOPSIS 

#include <fcnthh> 

res = fcntl (fd, cmd, arg) 

int res; 

tut fd, cmd, arg; 

DESCRIPTION 

fcntl performs a variety of functions on open descriptors. The argument fd is an open descrip- 
tor to be operated on by cmd as follows: 

FJ3UPFD Return a new descriptor as follows: 

Lowest numbered available descriptor greater than or equal to arg. 

References the same object as the original descriptor. 

New descriptor shares the same file pointer if the object was a file. 

Same access mode (read, write or read/write). 

Same file status flags (i.e., both descriptors share the same file status flags). 

The close-on-exec flag associated with the new descriptor is set to remain 
open across execve(2) system calls. 

FJGETFD Get the close-on-exec flag associated with the descriptor fd , If the low-order 

bit is 0, the file will remain open across exec, otherwise the file will be closed 
upon execution of exec. 

F_SETFD Set the close-on-exec flag associated with fd to the low order bit of arg (0 or 1 

as above). 

FJ3ETFL Get descriptor status flags, see /usr/include/fcntLh for their definitions. 

FJ3ETFL Set descriptor status flags, see /usr/include/fcntLh for their definitions. 

F_GETLK Get a description of the first lock which would block the lock specified in the 

flock structure pointed to by arg. The information retrieved overwrites the 
information in the flock structure. If no lock is found that would prevent this 
lock from being created, then the structure is passed back unchanged except 
for the lock type which will be set to FJJNLCK. 

F__SETLK Set or clear an advisory record lock according to the flock structure pointed 

to by arg. F^SETLK is used to establish shared (FJUDLCK) and exclusive 
(FJWRLCK) locks, or to remove either type of lock (F„UNLCK). If the 
specified lock cannot be applied, fcntl will return with an error value of -1. 

F__SETLKW This cmd is the same as F^SETLK except that if a shared or exclusive lock is 
blocked by other locks, the requesting process will sleep until the lock may be 
applied. 

F_GETOWN Get the process ID or process group currently receiving SIGIO and SIGURG 
signals; process groups are returned as negative values. 

F_SETOWN Set the process or process group to receive SIGIO and SIGURG signals; pro- 
cess groups are specified by supplying arg as negative, otherwise arg is inter- 
preted as a process ID. 

The SIGIO facilities are enabled by setting the FASYNC flag with F„SETFL. 
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NOTES 



Advisory locks allow cooperating processes to perform consistent operations on files, but do 
not guarantee exclusive access (i.e., processes may still access files without using advisory 
locks, possibly resulting in inconsistencies). 

The record locking mechanism allows two types of locks: shared locks (FJRDLCK) and 
exclusive locks (F_WRLCK). More than one process may hold a shared lock for a particular 
segment of a file at any given time, but multiple exclusive, or both shared and exclusive, locks 
may not exist simultaneously on any segment. 

In order to claim a shared lock, the descriptor must have been opened with read access. The 
descriptor on which an exclusive lock is being placed must have been opened with write 
access. 

A shared lock may be upgraded to an exclusive lock, and vice versa, simply by specifying the 
appropriate lock type with a cmd of F_SETLK or F_SETLKW; the previous lock will be 
released and the new lock applied (possibly after other processes have gained and released the 
lock). 

If the cmd is FJSETLKW and the requested lock cannot be claimed immediately (e.g., 
another process holds an exclusive lock that partially or completely overlaps the current 
request) then the calling process will block until the lock may be acquired. Processes blocked 
awaiting a lock may be awakened by signals. 

Care should be taken to avoid deadlock situations in applications in which multiple processes 
perform blocking locks on a set of common records. 

The record that is to be locked or unlocked is described by the flock structure, which is 
defined in <fcntl.h> as follows: 

struct flock { 

short Ltype; /* F_RDLCK, F.WRLCK, or FJUNLCK */ 

short Lwhence; /* flag to choose starting offset */ 

long Lstart; /* relative offset, in bytes */ 

long Lien; /* length, in bytes; means lock to EOF */ 

short Lpid; /* returned with FJ3ETLK */ 

}; 

The flock structure describes the type (Ijtype), starting offset (l_whence), relative offset 
(Ijstart), and size (IJen) of the segment of the file to be affected. L_whence must be set to 0, 
1, or 2 to indicate that the relative offset will be measured from the start of the file, current 
position, or end-of-file, respectively. The process id field (l_pid) is only used with the 
F_XjETLK cmd to. return the description of a lock held by another process. 

Locks may start and extend beyond the current end-of-file, but may not be negative relative to 
the beginning of the file. A lock may be set to always extend to the end-of-file by setting IJen 
to zero (0). If such a lock also has l_whence and Ijstart set to zero (0), the entire file will be 
locked. Changing or unlocking a segment from the middle of a larger locked segment leaves 
two smaller segments at either end. Locking a segment that is already locked by the calling 
process causes the old lock type to be removed and the new lock type to take affect. All 
locks associated with a file for a given process are removed when the file is closed or the pro- 
cess terminates. Locks are not inherited by the child process in &fork(2) system call. 

In order to maintain consistency in the network case, data must not be cached on client 
machines. For this reason, file buffering for an NFS file is turned off when the first lock is 
attempted on the file. Buffering will remain off as long as the file is open. Programs that do 
I/O buffering in the user address space, however, may have inconsistent results (the standard 
I/O package, for instance, is a common source of unexpected buffering). 
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The advisory record locking capabilities of fcntl are implemented throughout the network by 
the network lock daemon; see lockd(8C). If the file server crashes and is rebooted, the lock 
daemon will attempt to recover all locks that were associated with that server. If a lock can- 
not be reclaimed, the process that held the lock will be issued a SIGLOST signal. 

RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 

FJDUPFD A new descriptor. 

F_GETFD Value of flag (only the low-order bit is defined), 

F_GETFL Value of flags. 

F„GETOWN Value of descriptor owner. 

other Value other than -1. ■ 

Otherwise, a value of -1 is returned and errno is set to indicate the error. 

ERRORS 

fcntl will fail if one or more of the following are true: 

EBADF fd is not a valid open descriptor. 

[EMMMEILE cmd is F_J)UPFD and the maximum allowed number of descriptors are 
currently open. 

EINVAL cmd is FJPUPFD and arg is negative or greater than the maximum allowable 

number (see getdtablesize(2)), 

EFAULT cmd is F_GETLK, F_SETLK, or F_SETLKW and arg points to an invalid 

address. 

EINVAL cmd is F„GETLK, F_SETLK, or F_SETLKW and the data arg points to is 

not valid. 

EBADF cmd is F_SETLK or F_SETLKW and the process does not have the appropri- 

ate read or write permissions on the file. 

EAGAIN cmd is F_SETLK, the lock type (Ijype) is F_RDLCK (shared lock), and the 

segment of the file to be locked already has an exclusive lock held by another 
process. This error will also be returned if the lock type is FJWRLCK 
(exclusive lock) and another process already has the segment locked with 
either a shared or exclusive lock. 

cmd is F_SETLKW and a signal interrupted the process while it was waiting for 

the lock to be granted. 

ENOLCK and is F_SETLK or F„SETLKW and there are no more file lock entries 

available. 

SEE ALSO 

close(2), execve(2), getdtablesize(2), open(2V), sigvec(2), lockf(3), lockd(SC) 



BUGS 



File locks obtained through the fcntl mechanism do not interact in any way with those 
acquired vi&flock(2). They do, however, work correctly with the exclusive locks claimed by 
lockf(3). 

F_GETLK returns FJJNLCK if the requesting process holds the specified lock. Thus, there 
is no way for a process to determine if it is still holding a specific lock after catching a 
SIGLOST signal. 

In a network environment, the value of Ijpid returned by F_GETLK is next to useless. 
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NAME 

fixade - fix address exceptions (unaligned references) 

SYNOPSIS 

fixade (x) 
int x; 

DESCRIPTION 

This system call enables or disables kernel fix up of misaligned memory references. The MIPS 
hardware traps load and store operations where the address is not a multiple of the number of 
bytes loaded or stored. Usually this trap indicates incorrect program operation and so by 
default the kernel converts this trap into a SIGBUS signal to the process, typically causing a 
core dump for debugging. 

Older programs developed on systems with lax alignment constraints sometimes make occa- 
sional misaligned references in course of correct operation. The best way to port such pro- 
grams to MIPS hardware is to correct the program by aligning the data. A SIGBUS handler 
exists to assist the programmer in locating unaligned references. See unaligned (3). 

Some applications, however, must deal with unaligned data. The MIPS architecture provides 
special instructions, supported by builtin assembler macros, for loading and storing unaligned 
data. These applications can use these instructions where appropriate. Non-assembler pro- 
grams can access these instructions via calls, also described in unaligned (3). 

When it is inappropriate to modify the application to either align the data properly, or to use 
special access methods for unaligned data, this system call, fixade, can be used as a method of 
last resort. This system call directs the kernel to handle misaligned traps and emulate an 
unaligned reference. The program no longer receives a SIGBUS signal. This emulation is 
slow, and heavy use will significantly slow down program execution. 

A non-zero argument enables and a zero argument disables the fix up. 

If the program gets an address exception when making a reference outside its address space, it 
will still get a SIGBUS signal even if this is enabled. 

SEE ALSO 

unaligned(3) 
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NAME I 

flock - apply or remove an advisory lock on an open file V 

SYNOPSIS 

#indude <sys/file„h> 

#defineLOCK„SH 1 /* shared lock */ 

#defineLOCKJEX 2 /* exclusive lock */ 

#defineLOCK_NB 4 /* don't block when locking */ 

#defineLOCKJUN 8 /* unlock */ 

Hock(£d 9 operation) 
int fd 9 operation; 

DESCRIPTION 

flock applies or removes an advisory lock on the file associated with the file descriptor fd . A 
lock is applied by specifying an operation parameter that is the inclusive or of LOCKLSH or 
LOCKJBX and, possibly, LOCKJNHB. To unlock an existing lock operation should be 
LOCKJUN. 

Advisory locks allow cooperating processes to perform consistent operations on files, but do 
not guarantee consistency (i.e., processes may still access files without using advisory locks 
possibly resulting in inconsistencies). 

The locking mechanism allows two types of locks: shared locks and exclusive locks. At any 
time multiple shared locks may be applied to a file ? but at no time are multiple exclusive, or 
both shared and exclusive, locks allowed simultaneously on a file. 

A shared lock may be upgraded to an exclusive lock, and vice versa, simply by specifying the 
appropriate lock type; this results in the previous lock being released and the new lock applied ^ 

(possibly after other processes have gained and released the lock). I 

Requesting a lock on an object that is already locked normally causes the caller to be blocked 
until the lock may be acquired. If LOCK^NB is included in operation , then this will not hap- 
pen; instead the call will fail and the error EWOULDBLOCK will be returned. 

NOTES 

Locks are on files, not file descriptors. That is, file descriptors duplicated through dup(2) or 
fork (2) do not result in multiple instances of a lock, but rather multiple references to a single 
lock. If a process holding a lock on a file forks and the child explicitly unlocks the file, the 
parent will lose its lock. 

Processes blocked awaiting a lock may be awakened by signals. 

RETURN VALUE 

Zero is returned if the operation was successful; on an error a -1 is returned and an error 
code is left in the global location errno. 

ERRORS 

The flock call fails if: 

[EMWOULDBLOCK] The file is locked and the LOCKJ^B option was specified. 

[EBADF] The argument fd is an invalid descriptor. 

[EINVAL] The argument fd refers to an object other than a file. 

SEE ALSO 

open(2), close(2), dup(2), execve(2), fork(2) 
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NAME 

fork - create a new process 

SYNOPSIS 

pid =; forkO 
int pid; 

DESCRIPTION 

fork causes creation of a. new process. The new process (child process) is an exact copy of 
the calling process except for the following: 

The child process has a unique process ID. 

The child process has a different parent process ID (i.e., the process ID of the parent 
process). 

The child process has its own copy of the parent's descriptors. These descriptors refer- 
ence the same underlying objects, so that, for instance, file pointers in file objects are 
shared between the child and the parent, so that an lseek(2) on a descriptor in the child 
process can affect a subsequent read or write by the parent. This descriptor copying is 
also used by the shell to establish standard input and output for newly created processes 
as well as to set up pipes. 

The child processes resource utilizations are set to 0; see setrlimit(2). 



The child process does not receive real interval timer signals that were arranged by the 
parent; however, both virtual and profiling interval tinier signals will continue to arrive. 

RETURN VALUE 

Upon successful completion, fork returns a value of to the child process and returns the pro- 
cess ID of the child process to the parent process. Otherwise, a value of -1 is returned to the 
parent process, no child process is created, and the global variable errno is set to indicate the 
error. 

ERRORS 

fork will fail and no child process will be created if one or more of the following are true: 



[EAGAIN] 



[EAGAIN] 



[ENOMEM] 

SEE ALSO 

execve(2), wait(2) 



The system-imposed limit on the total number of processes under 
execution would be exceeded. This limit is configuration- 
dependent. 

The system -imposed limit MAXUPRC (<sys/param.h>) on the 
total number of processes under execution by a single user would 
be exceeded. 

There is insufficient swap space for the new process. 
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NAME I 

fp^sigintr - generate a SIGFPE signal on floating-point interrupts ^~ 

SYNOPSIS 

int fp__sigintr(x) 

int x; 

DESCRIPTION 

The fp^jigtintr system call causes every other floating-point interrupt to generate a SIGFPE sig- 
nal K the argument is 1 the next floating-point interrupt will cause a signal with the following 
one not causing a signal. If the argument is a 2 then the the next floating-point interrupt will 
not cause a signal with the following one causing a signal. If the argument is a then the this 
feature is disabled and floating-point interrupts will not cause a signal, 

This is intended for use by//?*' (3) to analyze the causes of floating-point interrupts. 

ALSO SEE 

fpi(3) 

R2010 Floating Point Coprocessor Architecture 
R2360 Floating Point Board Product Description 
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NAME 

fsync - synchronize a file's in-core state with that on disk 

SYNOPSIS 

fsync (fd) 
int fd; 

DESCRIPTION 

fsync causes all modified data and attributes of fd to be moved to a permanent storage device. 
This normally results in all in-core modified copies of buffers for the associated file to be writ- 
ten to a disk. 

fsync should be used by programs that require a file to be in a known state, for example, in 
building a simple transaction facility. 

RETURN VALUE 

A value is returned on success. A -1 value indicates an error. 

ERRORS 

The fsync fails if: 

[EBADF] Fd is not a valid descriptor. 

[EINVAL] fd refers to a socket, not to a file. 

[EIO] An I/O error occurred while reading from or writing to the file sys- 



tem. 



SEE ALSO 

sync(2), sync(8), update(8) 
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NAME 

getdirentries - gets directory entries in a filesystem independent format 

SYNOPSIS 

#include <®ys/dir«h> 

cc = getdirentries (fd 9 buf, nhytes f basep) 
int cc, fd; 
char *buf; 
int nbytes; 
long *basep; 

DESCRIPTION 

getdirentries attempts to put directory entries from the directory referenced by the file descrip- 
tor fd into the buffer pointed to by buf, in a filesystem independent format. Up to nbytes of 
data will be transferred, nbytes must be greater than or equal to the block size associated with 
the file, see stat(2) . Sizes less than this may cause errors on certain filesystems. 

The data in the buffer is a series of direct structures each containing the following entries: 

unsigned long djileno; 

unsigned short djreclen; 

unsigned short d_jiamlen; 

char d_name[MAXNAMELEN + 1]; /* see below */ 

The d_fileno entry is a number which is unique for each distinct file in the filesystem. Files 
that are linked by hard links (see link(2)) have the same djileno. The d_reclen entry is the 
length, in bytes, of the directory record. The d_jiame entry contains a null terminated file 
name. The d_jiamlen entry specifies the length of the file name. Thus the actual size of 
d_name may vary from 2 to MAXNAMELEN + 1. 

The structures are not necessarily tightly packed. The d_reclen entry may be used as an offset 
from the beginning of a direct structure to the next structure, if any. 

Upon return, the actual number of bytes transferred is returned. The current position pointer 
associated with/d is set to point to the next block of entries. The pointer is not necessarily 
incremented by the number of bytes returned by getdirentries. If the value returned is zero, 
the end of the directory has been reached. The current position pointer may be set and 
retrieved by lseek(2), getdirentries writes the position of the block read into the location 
pointed to by basep. It is not safe to set the current position pointer to any value other than a 
value previously returned by lseek(2) or a value previously returned in the location pointed to 
by basep or zero. 

RETURN VALUE 

If successful, the number of bytes actually transferred is returned. Otherwise, a -1 is returned 
and the global variable errno is set to indicate the error. 

ERRORS 

getdirentries will fail if one or more of the following are true: 

EBADF fd is not a valid file descriptor open for reading. 

EFAULT Either buf or basep point outside the allocated address space. 

EIO An I/O error occurred while reading from or writing to the file sys- 

tem. 

EINTR A read from a slow device was interrupted before any data arrived 

by the delivery of a signal. 



( 
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SEE ALSO 

open(2V), lseek(2) 
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NAME I 

getdomainname, setdomainname - get/set name of current domain * 

SYNOPSIS 

getdomaiimame(nanie, nameleo) 
char *name; 
int namelen; 

setd0maiiiiiame(eam€ 9 mameten) 
char #name; 
let n&raelen; 

DESCRIPTION 

getdomainname returns the name of the domain for the current processor, as previously set by 
setdomainname. The parameter namelen specifies the size of the name array. The returned 
name is null-terminated unless insufficient space is provided. 

setdomainname sets the domain of the host machine to be name, which has length namelen. 
This call is restricted to the super-user and is normally used only when the system is 

bootstrapped. 

The purpose of domains is to enable two distinct networks that may have host names in com- 
mon to merge. Each network would be distinguished by having a different domain name. At 
the current time, only the yellow pages service makes use of domains. 

RETURN VALUE 

K the call succeeds a value of is returned. If the call fails, then a value of -1 is returned and 
an error code is placed in the global location errno. 

ERRORS ^r 

The following errors may be returned by these calls: I 

EFAULT The name parameter gave an invalid address. 

EPERM The caller was not the super-user. This error only applies to set- 

domainname. 

WARNINGS 

Domain names are limited to 255 characters. 
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NAME 

getdtablesize - get descriptor table size 

SYNOPSIS 

nfds ™ getdtablesize 
int nfds; 

DESCRIPTION 

Each process has a fixed size descriptor table, which is guaranteed to have at least 20 slots. 
The entries in the descriptor table are numbered with small integers starting at 0. The call 
getdtablesize returns the size of this table. 

SEE ALSO 

close(2), dup(2), open(2), select(2) 
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NAME 

getgid ? getegid - get group identity 

SYNOPSIS 

#inelnde <sys/types.h> 

gid = getgid() 
gt«Lt gid; 

egid = getegidO 

gld„t €gid; 

DESCRIPTION 

getgid returns the real group ID of the current process,, getegid the effective group ID. 

The real group ID is specified at login time, 

. The effective group ID is more transients and determines additional access permission during- 

execution of a "set-group-ID" process ? and it is for such processes that getgid is most useful. 

SEE ALSO 

getuid(2) ? setregid(2) 3 setgid(3) 
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NAME 

getgroups - get group access list 

SYNOPSIS 

#include <sys/param.h> 

ngroups = getgroups (gidsetlen, gidset) 
int ngroups, gidsetlen, *gidset; 

DESCRIPTION 

getgroups gets the current group access list of the user process and stores it in the array gidset . 
The parameter gidsetlen indicates the number of entries that may be placed in gidset. get- 
groups returns the actual number of groups returned in gidset. No more than NGROUPS, as 
defined in <sys/param.h>, will ever be returned. 

RETURN VALUE 

A successful call returns the number of groups in the group set. A value of -1 indicates that 
an error occurred, and the error code is stored in the global variable errno . 

ERRORS 

The possible errors for getgroup are: 

[EINVAL] The argument gidsetlen is smaller than the number of groups in the 

group set. 

[EFAULT] The argument gidset specifies an invalid address. 

SEE ALSO 

setgroups(2), initgroups(3X) 

WARNING 

The gidset array should be of type gid_t, but remains integer for compatibility with earlier sys- 
tems. 
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NAME i 

gethostid, sethostid - get/ set unique identifier of current host ^- 

SYNOPSIS 

hostid = gethostid 
long hostid; 

sethostid (hostid) 

Song hostid; 

DESCRIPTION 

sethostid establishes a 32-bit identifier for the current processor that is intended to be unique 
among all UNIX systems in existence. This is normally a DARPA Internet address for the local 
machine. This call is allowed only to the super-user and is normally performed at boot time. 

gethostid returns the 32-bit identifier for the current processor. 

SEE ALSO 

hostid(l), gethostname(2) 

ERRORS 

32 bits for the identifier is too small. 
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NAME 

gethostname, sethostname - get/ set name of current host 

SYNOPSIS 

gethostname (name, namelen) 
char *name; 
int namelen; 

sethostname (name, namelen) 
char *name; 
int namelen; 

DESCRIPTION 

gethostname returns the standard host name for the current processor, as previously set by 
sethostname . The parameter namelen specifies the size of the name array. The returned name 
is null-terminated unless insufficient space is provided. 

sethostname sets the name of the host machine to be name , which has length namelen . This 
call is restricted to the super-user and is normally used only when the system is bootstrapped. 

RETURN VALUE 

If the call succeeds a value of is returned. If the call fails, then a value of -1 is returned and 
an error code is placed in the global location ermo. 

ERRORS 

The following errors may be returned by these calls: 

[EFAULT] The name or namelen parameter gave an invalid address. 

[EPERM] The caller tried to set the hostname and was not the super-user. 

[EINVAL] The size specified by I. namelen is longer than the maximum host name length. 

SEE ALSO 

gethostid(2) 

BUGS 

Host names are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters, currently 

64. 
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NAME 

getitimer, setitimer - get/ set value of interval timer 

SYNOPSIS 

#include <&ys/tiitie»h> 

#de§iie ITIMERJREAL /* real time intervals */ 

#deflne ITIMER_VIRTUAL 1 /# virtual time intervals */ 

#define ITIMERJPROF 2 /* user aed system virtual time */ 

getitimer(which 9 value) 

int which; 

struct itimerval *valne; 

setitimer(which f valee 9 ovalee) 

let which; 

struct Itimerval #va!iie 9 *©valee; 

DESCRIPTION 

The system provides each process with three interval timers, defined in <sys/ttineM>. The 
getitimer call returns the current value for the timer specified in which in the structure at value . 
The setitimer call sets a timer to the specified value (returning the previous value of the timer if 
ovalue is nonzero). 

A timer value is defined by the itimerval structure: 

struct itimerval { 

struct _ timeval itjnterval; /* timer interval */ 
struct timeval it_value; ■/* current value */ 

> ; 

If Upvalue is non-zero, it indicates the time to the next timer expiration. If itjnterval is non- 
zero, it specifies a value to be used in reloading Upvalue when the timer expires. Setting 
Upvalue to disables a timer. • Setting itjnterval to causes a timer to be disabled after its 
next expiration (assuming it_yalue is non-zero). 

Time values smaller than the resolution of the system clock are rounded up to this resolution 
(on the VAX, 10 milliseconds). 

The ITIMERJREAL timer decrements in real time. A SIGALRM signal is delivered when this 
■timer expires. 

The ITIMER„ VIRTUAL timer decrements in process virtual time. It runs only when the pro- 
cess is executing. A SIGVTALRM signal is delivered when it expires. 

The ITIMERJPROF timer decrements both in process virtual time and when the system is run- 
ning on behalf of the process. It is designed to be used by interpreters in statistically profiling 
the execution of interpreted programs. Each time the ITIMERJPRO timer expires, the SIG- 
PROF signal is delivered. Because this signal may interrupt in-progress system calls, programs 
using this timer must be prepared to restart interrupted system calls. 

NOTES 

Three macros for manipulating .time values are defined in <sys/time,h> . Timerclear sets a 
time value to zero, timerisset tests if a time value is non-zero, and timercmp compares two time 
values (beware that >= and <= do not work with this macro). 

RETURN VALUE 

If the calls succeed, a value of is returned. If an error occurs, the value -1 is returned, and 
a more precise error code is placed in the global variable errno. 



( 



( 
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ERRORS 

The possible errors are: 

[EFAULT] 

[EINVAL] 

SEE ALSO 

sigvec(2), gettimeofday(2) 



The value parameter specified a bad address. 

A value parameter specified a time was too large to be handled. 
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NAME / 

getpagesize - get system page size V 

SYNOPSIS 

pagesize = getpagesize 
let pagesize; 

DESCRIPTION 

getpagesize returns the number of bytes in a page. Page granularity is the granularity of many 
of the memory management calls. 

The page size is a system page size and may not be the same as the underlying hardware page 

size. 

SEE ALSO 

sbrk(2) ? pagesize(l) 



( 
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NAME 

getpeername - get name of connected peer 

SYNOPSIS 

getpeername(s, name, namelen) 

int s; 

struct sockaddr *name; 

int *namelen; 

DESCRIPTION 

getpeername returns the name of the peer connected to socket $. The namelen parameter 
should be initialized to indicate the amount of space pointed to by name . On return it con- 
tains the actual size of the name returned (in bytes). The name is truncated if the buffer pro- 
vided is too small. 

DIAGNOSTICS 

A is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

[EBADF] The argument s is not a valid descriptor. 

[ENOTSOCK] The argument s is a file, not a socket. 

[ENOTCONN] The socket is not connected. 

[ENOBUFS] Insufficient resources were available in the system to perform the 

operation. 

[EFAULT] The name parameter points to memory not in a valid part of the 

process address space. 

SEE ALSO 

accept(2), bind(2), socket(2), getsockname(2) 
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NAME 

getpgrp - get process group 

SYNOPSIS 

pgrp = getpgrp (pid) 
hit pgrp; 
lot pid; 

DESCRIPTION 

The process group of the specified process Is returned by getpgrp. lipid is zero, then the call 
applies to the current process. 

Process groups are used for distribution of signals, and by terminals to arbitrate requests for 
their input: processes that have the same process group as the terminal are foreground and 
may read, while others will block with a signal if they attempt to read. 

This call is thus used by programs such as csh(l) to create process groups in implementing job 
control The TIOCGPGRP and TIOCSPGRP calls described in tty(4) are used to get/set the 
process group of the control terminal. 

SEE ALSO 

setpgrp(2) ? getuid(2), tty(4) 



c 



( 
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NAME 

getpid, getppid - get process identification 

SYNOPSIS 

pid = getpid 
int pid; 

ppid - getppid () 
int ppid; 

DESCRIPTION 

getpid returns the process ID of the current process. Most often it is used to generate 
uniquely-named temporary files. 

getpid returns the process ID of the parent of the current process. 

SEE ALSO 

gethostid(2) 
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NAME 

getpriority, setpriority - get/ set program scheduling priority 

SYNOPSIS 

#indude <sys/re$ource.h> 

prio = getpriority (which, who) 
Int prio 9 which, who; 

8etpriority(which, who, prio) 
int which, who, prio; 

DESCRIPTION 

The scheduling priority of the process, process group, or user, as indicated by which and who 
is obtained with the getpriority call and set with the setpriority call, which is one of 
PRIO__PROCESS, PRIOJPGRP, or PRIOJJSER, and who is interpreted relative to which (a pro- 
cess identifier for PRIOJPRQCESS, process group identifier for PRIO_PGRP, and a user ID for 
PRIO_USER). A zero value of who denotes the current process, process group, or user, prio 
is a value in the range -20 to 20. The default priority is 0; lower priorities cause more favor- 
able scheduling. 

The getpriority call returns the highest priority (lowest numerical value) enjoyed by any of the 
specified processes. The setpriority call sets the priorities of all of the specified processes to 
the specified value. Only the super-user may lower priorities. 

RETURN VALUE 

Since getpriority can legitimately return the value -1, it is necessary to clear the external vari- 
able errno prior to the call, then check it afterward to determine if a -1 is an error or a legiti- 
mate value. The setpriority call returns if there is no error, or -1 if there is. 

ERRORS 

getpriority and setpriority may return one of the following errors: 

[ESRCH] No process was located using the which and who values specified. 

[EINVAL] which was not one of PRIO_PROCESS, PRIO_PGRP, or 

PRIOJJSER, 

In addition to the errors indicated above, setpriority may fail with one of the following errors 
returned: 

[EPERM] A process was located, but neither its effective nor real user ID 

matched the effective user ID of the caller. 

[EACCES] A non super-user attempted to lower a process priority. 

SEE ALSO 

nice(l), fork (2), renice(8) 



c 
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NAME 

getrlimit, setrlimit - control maximum system resource consumption 

SYNOPSIS 

#include <sys/time.h> 
#include <sys/re source. h> 

getrlimit(resource, rip) 
int resource; 
struct rlimit *rlp; 

setriimit(resource, rip) 
int resource; 
struct rlimit *rlp; 

DESCRIPTION 

Limits on the consumption of system resources by the current process and each process it 
creates may be obtained with the getrlimit call, and set with the setrlimit call. 

The resource parameter is one of the following: 

RLIMIT_CPU the maximum amount of cpu time (in seconds) to be used by each 

process. 

RLIMITJFSIZE the largest size, in bytes, of any single file that may be created. 

RLIMIT_DATA the maximum size, in bytes, of the data segment for a process; this 

defines how far a program may extend its break with the sbrk(2) 
system call. 

RLIMIT_STACK the maximum size, in bytes, of the stack segment for a process; 

this defines how far a program's stack segment may be extended. 
Stack extension is performed automatically by the system. 

RLIMIT_CORE the largest size, in bytes, of a core file that may be created. 

RLIMITJRSS the maximum size, in bytes, to which a process's resident set size 

may grow. This imposes a limit on the amount of physical 
memory to be given to a process; if memory is tight, the system 
will prefer to take memory from processes that are exceeding their 
declared resident set size. 

A resource limit is specified as a soft limit and a hard limit. When a soft limit is exceeded a 
process may receive a signal (for example, if the cpu time is exceeded), but it will be allowed 
to continue execution until it reaches the hard limit (or modifies its resource limit). The rlimit 
structure is used to specify the hard and soft limits on a resource, 

struct rlimit { 

int rlim_cur; /* current (soft) limit */ 

int rlim_max; /* hard limit */ 

}; 

Only the super-user may raise the maximum limits. Other users may only alter rlim_cur within 
the range from to rlim_max or (irreversibly) lower rlimjnax . 

An "infinite' ' value for a limit is defined as RLIMJNFINITY (0x7fffffff). 

Because this information is stored in the per-process information, this system call must be exe- 
cuted directly by the shell if it is to affect all future processes created by the shell; limit is thus 
a built-in command to csh(l). 
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The system refuses to extend the data or stack space when the limits would be exceeded in the | 

normal way: a break call fails if the data space limit is reached. When the stack limit is V 

reached, the process receives a segmentation fault (SIGSEGV); if this signal is not caught by a 
handler using the signal stack, this signal will kill the process. 

A file I/O operation that would create a file that is too large will cause a signal SIGXFSZ to be 
generated; this normally terminates the process, but may be caught. When the soft cpu time 
limit is exceeded, a signal SIGXCPU is sent to the offending process. 

RETURN VALUE 

A return value indicates that the call succeeded, changing or returning the resource limit. 
A return value of -1 indicates that an error occurred, and an error code is stored in the global 

location errno* 

ERRORS 

The possible errors are: 

{EFAULT] The address specified for rip is invalid. 

[EPERM] The limit specified to setrlimit would have raised the maximum 

limit value, and the caller is not the super-user. 

SEE ALSO 

csh(l), quota(2), sigvec(2), sigstack(2) 

WARNINGS 

There should be limit and unlimit commands msh\l) as well as in csh. 



( 
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NAME 

getrusage - get information about resource utilization 

SYNOPSIS 

#include <sys/time.h> 
#include <sys/re source. h> 

#define RUSAGEJSELF 

#define RUSAGE.CHELDREN -1 



/* calling process */ 

/* terminated child processes */ 



getrusage (who, rusage) 

int who; 

struct rusage *rusage; 

mips_getrusage(who, rusage, rusage_size) 

int who; 

struct rusage *rusage; 

int rusage_size; 

DESCRIPTION 

getrusage returns information describing the resources utilized by the current process, or all its 
terminated child processes. mips_getrusage performs the same function as getrusage but takes 
a third argument which is the size of the rusage structure. This interface will be used in the 
future to return MIPS hardware specific resource use information as the rusage structure is 
extended. 

The who parameter is one of RUSAGE_SELF or RUSAGE_CHILDREN. The buffer to which 
rusage points will be filled in with the following structure: 

struct rusage { 

/* user time used */ 
/* system time used */ 



}; 



struct timeval ru_utime; 

struct timeval ru_stinxe; 

int ru_maxrss; 

int ru_ixrss; 

int ru_idrss; 

int ru_isrss; 

int ru_minflt; 

int numajflt; 

int ru_nswap; 

int ru_inblock; 

int ru_oublock; 

int ru_msgsnd; 

int ru_msgrcv; 

int ru_nsignals; 

int ru_nvcsw; 

int ru_nivcsw; 



/* integral shared text memory size */ 

/* integral unshared data size */ 

/* integral unshared stack size */ 

/* page reclaims */ 

/* page faults */ 

/* swaps */ 

/* block input operations */ 

/* block output operations */ 

/* messages sent */ 

/* messages received */ 

/* signals received */ 

/* voluntary context switches */ 

/* involuntary context switches */ 



The fields are interpreted as follows: 

ru_utime the total amount of time spent executing in user mode. 

runtime the total amount of time spent in the system executing on behalf of the 

process(es). 

ru_maxrss the maximum resident set size utilized (in number of pages). 

ru_ixrss an "integral" value indicating the amount of memory used by the text 

segment that was also shared among other processes. This value is 
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m__idrss 

ru_isrss 

ru_minflt 

ru__majflt 
ru_nswap 
rujnblock 
ra„outblock 
ru_msgsnd 
• ra__msgrcv" 
ra„nsignals 
ru„nvcsw 

ru_nivcsw 



expressed in units of number of pages * second s-of-execution and is cal- 
culated by summing the number of shared memory pages in use each 
time the internal system clock ticks and then averaging over 1 second 
intervals. 

an integral value of the amount of unshared memory residing in the data 
segment of a process (expressed in units of number of pages * seconds- 
of -execution). 

an integral value of the amount of unshared memory residing in the 
stack segment of a process (expressed in units of number of pages * 
seconds-of -execution) . 

the number of page faults serviced without any I/O activity; here I/O 
activity is avoided by "reclaiming" a page frame from the list of pages 
awaiting reallocation, 

the number of page faults serviced that required I/O activity. 

the number of times a process was "swapped" out of main memory. 

the number of times the file system had to perform input. 

the number of times the file system had to perform output. 

the number of IPC messages sent. 

the number of IPC messages received. 

the number of signals delivered. 

the number of times a context switch resulted due to a process volun- 
tarily giving up the processor before its time slice was completed (usually 
to await availability of a resource). 

the number of times a context switch resulted due to a higher priority 
process becoming runnable or because the current process exceeded its 
time slice. 



c 



NOTES 



The numbers rujnblock and rujouiblock account only for real I/O; data supplied by the cach- 
ing mechanism is charged only to the first process to read or write the data. 

ERRORS 

The possible errors for getrumge are; 

[EINVAL] The who parameter is not a valid value. 

[EFAULT] The address specified by the rusage parameter is not in a valid part of 

the process address space. 

SEE ALSO 

gettimeofday(2), wait (2) 

WARNING 

There is no way to obtain information about a child process that has not yet terminated. 
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NAME 

getsockname - get socket name 

SYNOPSIS 

getsockname (s 9 name, namelen) 

int s; 

struct sockaddr *name; 

int *namelen; 

DESCRIPTION 

getsockname returns the current name for the specified socket. The namelen parameter should 
be initialized to indicate the amount of space pointed to by name . On return it contains the 
actual size of the name returned (in bytes). 

DIAGNOSTICS 

A is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

[EBADF] The argument s is not a valid descriptor. 

[ENOTSOCK] The argument s is a file, not a socket. 

[ENOBUFS] Insufficient resources were available in the system to perform the opera- 

tion. 

[EFAULT] The name parameter points to memory not in a valid part of the process 

address space. 

SEE ALSO 

bind(2), socket (2) 

WARNING 

Names bound to sockets in the UNIX domain are inaccessible; getsockname returns a zero 
length name. 



MIPS Computer Systems, Inc. February 5, 1989 Page 1 



GETSOCKOPT ( 2-BSD ) RISC/os Programmer's Reference GETSOCKOPT ( 2-BSD ) 



NAME 

getsockopt, setsockopt - get and set options on sockets 

SYNOPSIS 

#include <sys/types«li> 
#inclnde <sys/socket.h> 

getsockopt(s, level 9 optname, optval 9 optlen) 

let & 9 levels optnanie; 
char *optval; 
int *optlen; 

setsockopt (s, level, optname, optval^ optlen) 
int s, level 9 optname; 
char *optval; 
int. optlen; 

DESCRIPTION 

getsockopt and setsockopt manipulate options associated with a socket. Options may exist at 
multiple protocol levels; they are always present at the uppermost "socket" level. . 

When manipulating socket options the level at which the option resides and the name of the 
option must be specified, To manipulate options at the "socket" level, level is specified as 
SOL_SOCKET. To manipulate options at any other level the protocol number of the appropri- 
ate protocol controlling the option is supplied. For example, to indicate that an option is to 
be interpreted by the TCP protocol, level should be set to the protocol number of TCP; see 
getprotoent '(3N). 

The parameters optval and optlen are used to access option values for setsockopt. For get- 
sockopt they identify a buffer in which the value for the requested option(s) are to be 
returned. For getsockopt, optlen is a value-result parameter, initially containing the size of the 
buffer pointed to by optval, and modified on return to indicate the actual size of the value 
returned . If no option value is to be supplied or returned, optval may be supplied as 0. 

optname and any specified options are passed uninterpreted to the appropriate protocol 
module for interpretation. The include file <sys/ socket. h> contains definitions for "socket" 
level options, described below. Options at other protocol levels vary in format and name; 
consult the appropriate entries in section (4P), 

Most socket-level options take an int parameter for- optval. For setsockopt, the parameter 
should non-zero to enable a boolean option, or zero if the option is to be disabled. 
SOJLINGER uses a struct linger parameter, defined in <sys/ socket. h>, which specifies the 
desired state of the option and the linger interval (see below). 

The following options are recognized at the socket level. Except as noted, each may be exam- 
ined with getsockopt and set with setsockopt. 

SOJDEBUG toggle recording of debugging information 

SOJIEUSEADDR toggle local address reuse 

SOJKEEPALIVE toggle keep connections alive 

SO JDOMTROUTE toggle routing bypass for outgoing messages 

SOJLINGER linger on close if data 

SOJBROADCAST toggle permission to transmit broadcast messages 

SO_OOBIMLIME toggle reception of out-of-band data in 

SO_SNDBUF set buffer size for output _ 

SO JtCVBUF set buffer size for input 

SO JTYPE get the type of the socket 

SOJERROR get and clear error on the 
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SO_DEBUG enables debugging in the underlying protocol modules. SO_REUSEADDR indi- 
cates that the rules used in validating addresses supplied in a bind (2) call should allow reuse of 
local addresses. SO__KEEPALIVE enables the periodic transmission of messages on a con- 
nected socket. Should the connected party fail to respond to these messages, the connection 
is considered broken and processes using the socket are notified via a SIGPIPE signal. 
SOJDONTROUTE indicates that outgoing messages should bypass the standard routing facili- 
ties. Instead, messages are directed to the appropriate network interface according to the net- 
work portion of the destination address. 

SO_LINGER controls the action taken when unsent messags are queued on socket and a 
close(2) is performed. If the socket promises reliable delivery of data and SOJLINGER is set, 
the system will block the process on the close attempt until it is able to transmit the data or 
until it decides it is unable to deliver the information (a timeout period, termed the linger 
interval, is specified in the setsockopt call when SO_LINGER is requested). If SOJLINGER is 
disabled and a close is issued, the system will process the close in a manner that allows the 
process to continue as quickly as possible. 

The option SOJBROADCAST requests permission to send broadcast datagrams on the socket. 
Broadcast was a privileged operation in earlier versions of the system. With protocols that 
support out-of-band data, the SO__OOBINLINE option requests that out-of-band data be placed 
in the normal data input queue as received; it will then be accessible with recv or read calls 
without the MSG_OOB flag. SCLSNDBUF and SOJICVBUF are options to adjust the normal 
buffer sizes allocated for output and input buffers, respectively. The buffer size may be. 
increased for high-volume connections, or may be decreased to limit the possible backlog of 
incoming data. The system places an absolute limit on these values. Finally, SO_TYPE and 
SO_ERROR are options used only with setsockopt. SCLTYPE returns the type of the socket, 
such as SOCK_STREAM; it is useful for servers that inherit sockets on startup. SO_ERROR 
returns any pending error on the socket and clears the error status. It may be used to check 
for asynchronous errors on connected datagram sockets or for other asynchronous errors. 

RETURN VALUE 

A is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

[EBADF] The argument s is not a valid descriptor. 

[ENOTSOCK] The argument $ is a file, not a socket. 

[ENOPROTOOPT] The option is unknown at the level indicated. 

[EFAULT] The address pointed to by optval is not in a valid part of the process 

address space. For getsockopt, this error may also be returned if optlen 
is not in a valid part of the process address space. 

SEE ALSO 

ioctl(2), socket(2), getprotoent(3N) 

WARNING 

Several of the socket options should be handled at lower levels of the system. 
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NAME 

gettimeofday, settimeofday - get/ set date and time 

SYNOPSIS 

#include <sys/time.h> 

gettime®£day(tp 9 tzp) 
struct timeyal *tp; 
struct timezone #tzp; 

settimeofday(tp 9 tzp) 
struct timeval *tp; 
struct timezone *tzp; 

DESCRIPTION 

The system's notion of the current Greenwich time and the current time zone is obtained with 
the gettimeofday call, and set with the settimeofday call. The time is expressed in seconds and 
microseconds since midnight (0 hour), January 1, 1970. The resolution of the system clock is 
hardware dependent, and the time may be updated continuously or in "ticks." If tzp is zero, 
the time zone information will not be returned or set. 

The structures pointed to by tp and tzp are defined in <$y$/time.h> as: 

struct timeval { 

long tv__sec; /* seconds since Jan. 1, 1970 */ 

long tv__usec; /* and microseconds */ 

}; 



struct timezone { 
int tz 
int tz__dsttime; /* type of dst correction to apply */ 



int tz_minuteswest;/* of Greenwich */ f 



}; 

The timezone structure indicates the local time zone (measured in minutes of time westward 
from Greenwich), and a flag that, if nonzero, indicates that Daylight Saving time applies 
locally during the appropriate part of the year. 

Only the super-user may set the time of day or time zone. 

RETURN 

A return value indicates that the call succeeded. A -1 return value indicates an error 
occurred, and in this case an error code is stored into the global variable errno, 

ERRORS 

The following error codes may be set in errno: 

[EFAULT] An argument address referenced invalid memory. 

[EPER3M] A user other than the super-user attempted to set the time. 

SEE ALSO 

date(l), adjtime(2), ctime(3), timed(8) 



( 
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NAME 

getuid, geteuid - get user identity 

SYNOPSIS 

#include <sys/types.h> 

uid = getoidQ 
uid_t uid; 

euid = geteuid 
uid_t euid; 

DESCRIPTION 

getuid returns the real user ID of the current process, geteuid the effective user ID. 

The real user ID identifies the person who is logged in. The effective user ID gives the process 
additional permissions during execution of "set-user-ID" mode processes, which use getuid to 
determine the real-user-id of the process that invoked them. 

SEE ALSO 

getgid(2), setreuid(2) 
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NAME 

hwconf - get or set hardware configuration information 

SYNOPSIS 

#inchicle <machine/hwconf»h> 

hwconf(option 9 conf) 
lot option; 

struct hw_eonflg *conf; 

DESCRIPTION 

The hwconf system call allows a user process to get or set hardware configuration information. 
The specific contents of the hardware configuration structure is dependent upon the particular 
release of the kernel and the hardware configuration, but typical contents include MIPS chip 
types and revision numbers, MIPS board types and revision numbers and serial numbers, and 
non-volatile RAM, NVRAM, environment variables names and values. 

option indicates whether the hardware configuration information should be retrieved or 
modified. 

option may be one of: 

HWCONFJ3ET Return the hardware configuration information 

HWCONF_SET Set the specified NVRAM environment variable to the value indicated in 

conf . To use this option, call hwconf with the HWCONF„GET option, 
modify the value for the desired NVRAM variable, and then call hwconf 
with the HWCONF„SET option. Must be super-user. 

RETURN VALUE ^ 

hdwconf returns the a -1 on failure with errno set to the specific error. I 

ERRORS 

[EINVAL] option is not one of HWCONF_GET or HWCONFJSET. 

[EFAULT] conf is not accessable. 

[EACCES] Attempt to modify NVRAM environment variable when not super-user. 

SEE ALSO 

hwconf(8) 

"System Programmer's Guide" 

WARNING 

MIPS memory board idprom information should be added. 
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NAME 

intro - introduction to system calls and error numbers 

SYNOPSIS 

#include <sys/errno.h> 

DESCRIPTION 

This section describes all of the system calls. Most of these calls have one or more error 
returns. An error condition is indicated by an otherwise impossible return value. This is 
almost always -1; the individual descriptions specify the details. Note that a number of sys- 
tem calls overload the meanings of these error numbers, and that the meanings must be inter- 
preted according to the type and circumstances of the call. 

As with normal arguments, all return codes and values from functions are of type integer 
unless otherwise noted. An error number is also made available in the external variable errno, 
which is not cleared on successful calls. Thus errno should be tested only after an error has 
occurred. 

The following is a complete list of the errors and their names as given in <sys/errno.h>. 
Unused. Typically this error indicates an attempt to modify a file in some way forbidden 
except to its owner or super-user. It is also returned for attempts by ordinary users to do 
things allowed only to the super-user. This error occurs when a file name is specified and the 
file should exist but doesn't, or when one of the directories in a path name does not exist. 
The process or process group whose number was given does not exist, or any such process is 
already dead. An asynchronous signal (such as interrupt or quit) that the user has elected to 
catch occurred during a system call. If execution is resumed after processing the signal and 
the system call is not restarted, it will appear as if the interrupted system call returned this 
error condition. Some physical I/O error occurred during a read or write. This error may in 
some cases occur on a call following the one to which it actually applies. I/O on a special file 
refers to a subdevice that does not exist, or beyond the limits of the device. It may also occur 
when, for example, an illegal tape drive unit number is selected or a disk pack is not loaded 
on a drive. An argument list longer than 20480 bytes (or the current limit, NCARGS in 
<$y$Iparam.h>) is presented to execve, A request is made to execute a file that, although it 
has the appropriate permissions, does not start with a valid magic number, (see a.out(5)). 
Either a file descriptor refers to no open file, or a read (resp. write) request is made to a file 
that is open only for writing (resp. reading), wait and the process has no living or unwaited- 
for children. In a fork, the system's process table is full or the user is not allowed to create 
any more processes. During an execve or break, a program asks for more core or swap space 
than the system is able to supply, or a process size limit would be exceeded. A lack of swap 
space is normally a temporary condition; however, a lack of core is not a temporary condi- 
tion; the maximum size of the text, data, and stack segments is a system parameter. Soft lim- 
its may be increased to their corresponding hard limits. An attempt was made to access a file 
in a way forbidden by the protection system. The system encountered a hardware fault in 
attempting to access the arguments of a system call. A plain file was mentioned where a 
block device was required, e.g., in mount. An attempt to mount a device that was already 
mounted or an attempt was made to dismount a device on which there is an active file (open 
file, current directory, mounted-on file, or active text segment). A request was made to an 
exclusive access device that was already in use. An existing file was mentioned in an inap- 
propriate context, e.g., link. A hard link to a file on another device was attempted. An 
attempt was made to apply an inappropriate system call to a device, e.g., to read a write-only 
device, or the device is not configured by the system. A non-directory was specified where a 
directory is required, for example, in a path name or as an argument to chdir. An attempt to 
write on a directory. Some invalid argument: dismounting a non-mounted device, mentioning 
an unknown signal in signal, or some other argument inappropriate for the call. Also set by 
math functions, (see math(3)). The system's table of open files is full, and temporarily no 
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more opens can be accepted. As released, the limit on the number of open files per process £ 

is 64. getdtablesize(2) will obtain the current limit. Customary configuration limit on most * 

other UNIX systems is 20 per process. The file mentioned in an ioctl is not a terminal or one 
of the devices to which this call applies. An attempt to execute a pure-procedure program 
that is currently open for writing. Also an attempt to open for writing a pure-procedure pro- 
gram that is being executed. The size of a file exceeded the maximum (about 2 bytes). A 
write to an ordinary file, the creation of a directory or symbolic link, or the creation of a 
directory entry failed because no more disk blocks are available on the file system, or the allo- 
cation of an inode for a newly created file failed because no more modes are available on the 
file system. An Iseek was issued to a socket or pipe. This error may also be issued for other 
non-seekable devices. An attempt to modify a file or directory was made on a device 
mounted read-only. An attempt to make more than 32767 hard links to a file. A write on a 
pipe or socket for which there is no process to read the data. This condition normally gen- 
erates a signal; the error is returned if the signal is caught or ignored. The argument of a func- 
tion in the math package (3M) is out of the domain of the function. The value of a function 
in the math package (3M) is unrepresentable within machine precision. An operation that 
would cause a process to block was attempted on an object in non-blocking mode (see 
fcntl(2)). An operation that takes a long time to complete (such as a connect(2)) was 
attempted on a non-blocking object (see fcntl(2)). An operation was attempted on a non- 
blocking object that already had an operation in progress. Self-explanatory. A required 
address was omitted from an operation on a socket. A message sent on a socket was larger 
than the internal message buffer or some other network limit. A protocol was specified that 
does not support the semantics of the socket type requested. For example, you cannot use the 
ARPA Internet UDP protocol with type SOCK_STREAM. A bad option or level was specified 
in a getsockopt(2) or setsockopt(2) call. The protocol has not been configured into the system 
or no implementation for it exists. The support for the socket type has not been configured 
into the system or no implementation for it exists. For example, trying to accept a connection 
on a datagram socket. The protocol family has not been configured into the system or no 
implementation for it exists. An address incompatible with the requested protocol was used. 
For example, you shouldn't necessarily expect to be able to use NS addresses with ARPA 
Internet protocols. Only one usage of each address is normally permitted. Normally results 
from an attempt to create a socket with an address not on this machine. A socket operation 
encountered a dead network. A socket operation was attempted to an unreachable network. 
The host you were connected to crashed and rebooted. A connection abort was caused inter- 
nal to your host machine. A connection was forcibly closed by a peer. This normally results 
from a loss of the connection on the remote socket due to a timeout or a reboot. An opera- 
tion on a socket or pipe was not performed because the system lacked sufficient buffer space 
or because a queue was full, A connect request was made on an already connected socket; or, 
a sendto or sendmsg request on a connected socket specified a destination when already con- 
nected. An request to send or receive data was disallowed because the socket is not con- 
nected and (when sending on a datagram socket) no address was supplied. A request to send 
data was disallowed because the socket had already been shut down with a previous shut- 
down (2) call. A connect or send request failed because the connected party did not properly 
respond after a period of time. (The timeout period is dependent on the communication pro- 
tocol.) No connection could be made because the target machine actively refused it. This usu- 
ally results from trying to connect to a service that is inactive on the foreign host. A path 
name lookup involved more than 8 symbolic links. A component of a path name exceeded 
255 (MAXNAMELEN) characters, or an entire path name exceeded 1023 (MAXPATHLEN-l) 
characters. A socket operation failed because the destination host was down. A socket 
operation was attempted to an unreachable host. A directory with entries other than "." and 
".." was supplied to a remove directory or rename call. A write to an ordinary file, the crea- 
tion of a directory or symbolic link, or the creation of a directory entry failed because the 
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user's quota of disk blocks was exhausted, or the allocation of an inode for a newly created 
file failed because the user's quota of inodes was exhausted. A client referenced an open file, 
but the file has been deleted. An attempt was made to remotely mount a file system into a 
path which already has a remotely mounted component. 

DEFINITIONS 

Process ID 

Each active process in the system is uniquely identified by a positive integer called a process 
ID. The range of this ID is from to 30000. 

Parent process ID A new process is created by a currently active process; (see fork (2)). The 
parent process ID of a process is the process ID of its creator. 

Process Group ID Each active process is a member of a process group that is identified by a 
positive integer called the process group ID. This is the process ID of the group leader. This 
grouping permits the signaling of related processes (see killpg{2)) and the job control mechan- 
isms of csh(l). 

Tty Group ID Each active process can be a member of a terminal group that is identified by a 
positive integer called the tty group ID. This grouping is used to arbitrate between multiple 
jobs contending for the same terminal; (see csh(l) and tty (A)). 

Real User ID and Real Group Each user on the system is identified by a positive integer 
termed the real user ID. 

Each user is also a member of one or more groups. One of these groups is distinguished from 
others and used in implementing accounting facilities. The positive integer corresponding to 
this distinguished group is termed the real group ID. 

All processes have a real user ID and real group ID. These are initialized from the equivalent 
attributes of the process that created it. 

Effective User Id, Effective Group Id, Access to system resources is governed by three values: 
the effective user ID, the effective group ID, and the group access list. 

The effective user ID and effective group ID are initially the process's real user ID and real 
group ID respectively. Either may be modified through execution of a set-user-ID or set- 
group-ID file (possibly by one its ancestors) (see execve(2)). 

The group access list is an additional set of group ID's used only in determining resource 
accessibility. Access checks are performed as described below in "File Access Permissions". 

Super-user A process is recognized as a super-user process and is granted special privileges if 
its effective user ID is 0. 

Special Processes The processes with a process ID's of 0, 1, and 2 are special. Process is 
the scheduler. Process 1 is the initialization process init, and is the ancestor of every other 
process in the system. It is used to control the process structure. Process 2 is the paging dae- 
mon. 

Descriptor An integer assigned by the system when a file is referenced by open (2) or dup(2), 
or when a socket is created by pipe (2), socket(2) or socketpair(2), which uniquely identifies an 
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access path to that file or socket from a given process or any of its children. i 

File Name Names consisting of up to 255 (MAXNAMELEN) characters may be used to name 
an ordinary file, special file, or directory. 

These characters may be selected from the set of all ASCII character excluding (null) 
and the ASCII code for / (slash). (The parity bit, bit 8, must be 0.) 

Note that it is generally unwise to use *, ?, [ or ] as part of file names because of the special 
meaning attached to these characters by the shell. 

Path Name A path name is a null-terminated character string starting with an optional slash 
(/), followed by zero or more directory names separated by slashes, optionally followed by a 
file name. The total length of a path name must be less than 1024 (MAXPATHLEN) charac- 
ters. 

If a path name begins with a slash, the path search begins at the root directory. Otherwise, 
the search begins from the current working directory. A slash by itself names the root direc- 
tory. A null pathname refers to the current directory. 

Directory A directory is a special type of file that contains entries that are references to other 
files. Directory entries are called links. By convention, a directory contains at least two links, 
. and ,., referred to as dot and dot-dot respectively. Dot refers to the directory itself and dot- 
dot refers to its parent directory. 

Root Directory and Current Working Directory Each process has associated with it a concept ^ 

of a root directory and a current working directory for the purpose of resolving path name I 

searches, A process's root directory need not be the root directory of the root file system. 

File Access Permissions Every file in the file system has a set of access permissions. These 
permissions are used in determining whether a process may perform a requested operation on 
the file (such as opening a file for writing). Access permissions are established at the time a 
file is created. They may be changed at some later time through the chrnod(2) call. 

File access is broken down according to whether a file may be: read, written, or executed. 
Directory files use the execute permission to control if the directory may be searched. 

File access permissions are interpreted by the system as they apply to three different classes of 
users: the owner of the file, those users in the file's group, anyone else. Every file has an 
independent set of access permissions for each of these classes. When an access check is 
made, the system decides if permission should be granted by checking the access information 
applicable to the caller. 

Read, write, and execute/search permissions on a file are granted to a process if: 

The process's effective user ID is that of the super-user. 

The process's effective user ID matches the user ID of the owner of the file and the owner per- 
missions allow the access. 

The process's effective user ID does not match the user ID of the owner of the file, and either 
the process's effective group ID matches the group ID of the file, or the group ID of the file is 
in the process's group access list, and the group permissions allow the access. 

Neither the effective user ID nor effective group ID and group access list of the process match 
the corresponding user ID and group ID of the file, but the permissions for "other users" allow 

access. 
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Otherwise, permission is denied. 

Sockets and Address Families A socket is an endpoint for communication between processes. 
Each socket has queues for sending and receiving data. 

Sockets are typed according to their communications properties. These properties include 
whether messages sent and received at a socket require the name of the partner, whether com- 
munication is reliable, the format used in naming message recipients, etc. 

Each instance of the system supports some collection of socket types; consult socket{2) for 
more information about the types available and their properties. 

Each instance of the system supports some number of sets of communications protocols. 
Each protocol set supports addresses of a certain format. An Address Family is the set of 
addresses for a specific group of protocols. Each socket has an address chosen from the 
address family in which the socket was created. 

SEE ALSO 

intro(3), perror(3) 
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NAME 

ioctl - control device 

SYNOPSIS 

#Inelude <sys/ioctLh> 

. ioctl (d, request, argp) 

kit d; 

unsigned long request; 

char *&rgp; 

DESCRIPTION 

ioctl performs a variety of functions on open descriptors. In particular, many operating 
characteristics of character special files (e.g. terminals) may be controlled with ioctl requests. 
The writeups of various devices in section 4 discuss how ioctl applies to them. 

An ioctl request has encoded in it whether the argument is an "in" parameter or "out" 
parameter, and the size of the argument argp in bytes. Macros and defines used in specifying 
an ioctl request are located in the file <sys/ioctl.h> . 

RETURN VALUE 

If an error has occurred, a value of -1 is returned and errno is set to indicate the error. 

ERRORS 

ioctl will fail if one or more of the following are true: 

[EBADF] D is not a valid descriptor. 

[ENOTTY] D is not associated with a character special device. 

[ENOTTY] The specified request does not apply to the kind of object that the 

descriptor d references. | 

[EINVAL] Request or argp is not valid. 

SEE ALSO 

execve(2), fcntl(2), mt(4), tty(4), intro(4N), ad(4), arp(4), bk(4), de(4), dmc(4), ec(4), en(4), 
ex(4), hy(4), ik(4), il(4), imp(4), inet(4F), ix(4), lo(4), mtio(4), np(4), pcl(4), ps(4), pty(4), 
qe(4), rx(4), tb(4), un(4), uu(4), va(4), vp(4), vv(4) 



( 
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NAME 

kill - send signal to a process 

SYNOPSIS 

kill (pid, sig) 
int pid, sig; 

DESCRIPTION 

kill sends the signal sig to a process, specified by the process number pid. sig may be one of 
the signals specified in sigvec(2), or it may be 0, in which case error checking is performed but 
no signal is actually sent. This can be used to check the validity of pid. 

The sending and receiving processes must have the same effective user ID, otherwise this call 
is restricted to the super-user. A single exception is the signal SIGCONT, which may always be 
sent to any descendant of the current process. 

If the process number is 0, the signal is sent to all processes in the sender's process group; 
this is a variant of killpg(2). 

If the process number is -1 and the user is the super-user, the signal is broadcast universally 
except to system processes and the process sending the signal. If the process number is -1 
and the user is not the super-user, the signal is broadcast universally to all processes with the 
same uid as the user except the process sending the signal. No error is returned if any process 
could be signaled. 

For compatibility with System V, if the process number is negative but not -1, the signal is 
sent to all processes whose process group ID is equal to the absolute value of the process 
number. This is a variant of killpg(2). 

Processes may send signals to themselves. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

ERRORS 

kill will fail and no signal will be sent if any of the following occur: 

[EINVAL] sig is not a valid signal number. 

[ESRCH] No process can be found corresponding to that specified by pid. 

[ESRCH] The process id was given as but the sending process does not have a 

process group. 

[EPERM] The sending process is not the super-user and its effective user id does 

not match the effective user-id of the receiving process. When signaling 
a process group, this error was returned if any members of the group 
could not be signaled. 

SEE ALSO 

getpid(2), getpgrp(2), killpg(2), sigvec(2) 
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NAME I 

killpg - send signal to a process group ^ 

SYNOPSIS 

kiHpg(pgrp 9 sig) 
intpgrp, sig; 

DESCRIPTION 

killpg sends the signal sig to the process group pgrp . See sigvec{2) for a list of signals. 

The sending process and members of the process group must have the same effective user ID, 
or the sender must be the super-user. As a single special case the continue signal SIGCONT 
may be sent to any process that is a descendant of the current process. 

RETURN VALUE 

Upon successful completion, a value of is returned/ Otherwise, a value of -1 is returned 
and the global variable errno is set to indicate the error. 

ERRORS 

killpg will fail and not signal will be sent if any of the following occur: 

[EINVAL] Sig is not a valid signal number. 

[ESRCH] No process can be found in the process group specified by pgrp, 

[ESRCH] The process group was given as but the sending process does not have 

a process group. 

[EPERM] The sending process is not the super-user and oi^e or more of the target 

processes has an effective user ID different from that of the sending pro- 
cess. 

SEE ALSO f^ 



kiU(2), getpgrp(2), sigvec(2) 
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NAME 

kopt - get or set kernel options 

SYNOPSIS 

#include <mips/debug.h> 

kopt (option, value, op) 
char *option; 
int value, op; 

DESCRIPTION 

The kopt system call allows a user process to get or set kernel options. The specific set of 
options is dependent upon the particular release of the kernel, but typical options control vir- 
tual memory system parameters, debugging options, and device driver options. 

option points to a null-terminated character string naming a kernel option. The current set of 
kernel options is specified by the array kemargs in the kernel source file mips/ kopt x. 

op may be one of: 

KOPTJ3ET Return the specified option 

JyOPTJSET Set the specified option to value. Must be super-user. 

KOPTJBIS Or the bits in value into the specified option. Must be super-user. 

KOPTJ3IC Clear the bits in value from the specified option. Must be super-user. 

RETURN VALUE 

kopt returns the previous value of the specified option on success, or -1 on failure. Since -1 is 
a legal value for many kernel options, errors must be disambiguated from successful returns of 
-1 by the value of errno . 

ERRORS 

option name is too long. 

option is not known kernel option. 

op is not one of KOPT_GET, KOPT^SET, KOPTJBIS, or KOPT.BIC 

option is not accessable. 

Attempt to modify kernel option when not super-user. 



[EINVAL] 
[EINVAL] 
[EINVAL] 
[EFAULT] 
[EACCES] 

SEE ALSO 

kopt(8) 
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NAME 



link - make a hard link to a file 



SYNOPSIS 

link (namel, name2) 
char enamel , *name2; 

DESCRIPTION 

A hard link to name 1 is created; the link has the name name!, name J must exist. 

With hard links, both name! and name2 must be in the same file system. Unless the caller is 
the super-user , namel must not be a directory. Both the old and the new link share equal 
access and rights to the underlying object. 

RETURN VALUE 

Upon successful completion, a value of is returned, 
and errno is set to indicate the error. 



Otherwise, a value of -1 is returned 



ERRORS 

link will fail and no link will be created if one or more of the following are true: 

[ENOTDIR] A component of either path prefix is not a directory. 

[EINVAL] Either pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of either pathname exceeded 255 characters, or entire 
length of either path name exceeded 1023 characters. 

[ENOENT] A component of either path prefix does not exist. 

[EACCES] A component of either path prefix denies search permission. 

[EACCES] The requested link requires writing in a directory with a mode that 

denies write permission. 

[ELOOP] Too many symbolic links were encountered in translating one of the 

pathnames. 

[ENOENT] The file named by namel does not exist. 

[EEXIST] The link named by name2 does exist. 

[EPERM] The file named by namel is a directory and the effective user ID is not 

super-user. 

[EXDEV] The link named by namel and the file named by namel are on different 

file systems; 

[ENOSPC] The directory in which the entry for the new link is being placed cannot 

be extended because there is no space left on the file system containing 
the directory. 

[EDQUOT] The directory in which the entry for the new link is being placed cannot 

be extended because the user's quota of disk blocks on the file system 
containing the directory has been exhausted. 

An I/O error occurred while reading from or writing to the file system to 
make the directory entry. 

The requested link requires writing in a directory on a read-only file sys- 
tem. 



[EIO] 

[EROFS] 

[EFAULT] 



One of the pathnames specified is outside the process's allocated 
address space. 



c 



( 
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SEE ALSO 

symlink(2), unlink(2) 
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NAME 

listen - listen for connections on a socket 

SYNOPSIS 

listen (s, backlog) 
fait s, backlog; 

DESCRIPTION 

To accept connections, a socket is first created with socketQ), a willingness to accept incom- 
ing connections and a queue limit for incoming connections are specified with listen (2), and 
then the connections are accepted with accept (2). The listen call applies only to sockets of 
type SOCK^STREAM or SOCKJSEQPACKET, 

The backlog parameter defines the maximum length the queue of pending connections may 
grow to. If a connection request arrives with the queue full the client may receive an error 
with an indication of ECONNREFUSED, or, if the underlying protocol supports retransmis- 
sion, the request may be ignored so that retries may succeed, 

RETURN VALUE 

A return value indicates success; -1 indicates an error. 

ERRORS 

The call fails if: 

[EBADF] The argument s is not a valid descriptor. 

[ENOTSO.CK] The argument s is not a socket. 

[EOFNOTSUFP] The socket is not of a type that supports the operation listen. 

SEE ALSO 

accept (2), connect(2), socket(2) | 

WARNING 

The backlog is currently limited (silently) to 5. 



( 
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NAME 

Iseek - move read/write pointer 

SYNOPSIS 

#incliide <sys/file.h> 

#define L_SET /* set the seek pointer */ 
#define LJNCR 1 /* increment the seek pointer */ 
#define L_XTND 2 /* extend the file size */ 

pos = lseek(d, offset, whence) 
off_t pos; 
int d; 

oflLt offset; 
int whence; 

DESCRIPTION 

The descriptor d refers to a file or device open for reading and/or writing. Iseek sets the file 
pointer of d as follows: 

If whence is L_SET, the pointer is set to offset bytes. 

If whence is LJNCR, the pointer is set to its current location plus offset. 

If whence is L„XTND, the pointer is set to the size of the file plus offset. 

Upon successful completion, the resulting pointer location as measured in bytes from begin- 
ning of the file is returned. Some devices are incapable of seeking. The value of the pointer 
associated with such a device is undefined. 

NOTES 

Seeking far beyond the end of a file, then writing, creates a gap or "hole", which occupies no 
physical space and reads as zeros. 

RETURN VALUE 

Upon successful completion, the current file pointer value is returned. Otherwise, a value of 
-1 is returned and errno is set to indicate the error. 

ERRORS 

Iseek will fail and the file pointer will remain unchanged if; 

[EBADF] fildes is not an open file descriptor. 

[EINVAL] fildes is associated with a pipe or a socket. 

[EINVAL] whence is not a proper value. 

SEE ALSO 

dup(2), open (2) 

WARNING 

This document's use of whence is incorrect English, but maintained for historical reasons. 
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NAME 

mipsfpu - enabling and dissabling the floating-point unit 

SYNOPSIS 
int 

mipsSpu(x) 
int x; 

DESCRIPTION 

This system call is used to enable and disable the floating-point unit. An non-zero argument 
enables and a zero argument disables the floating-point unit. When disabled the system emu- 
lates all instructions in software. This can only be executed by the super-user. 

ERRORS 

mipsfpu fails when the following occurs: 

EPERM The caller is not the super-user. 

WARNING ^ 

H you disable a floating-point unit which produces imprecise exceptions (the R2360) just as a 
program using the floating-point unit is handling a signal which is trying to retrieve the 
floating-point instruction causing the signal based on the floating-point unit's implementation 
revision register that program will fail to get the floating-point instruction that caused the sig- 
nal. This is because the implementation revision register changed between the time the 
instruction causing the signal was executed and the time signal handler handled it. 



( 



( 
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NAME 



mknod - make a special file 



SYNOPSIS 

mknod (path, mode, dev) 
char *path; 
int mode, dev; 

DESCRIPTION 

mknod creates a new file whose name is path. The mode of the new file (including special file 
bits) is initialized from mode. (The protection part of the mode is modified by the process's 
mode mask (see uma$k(2))). The first block pointer of the i-node is initialized from dev and 
is used to specify which device the special file refers to. 

If mode indicates a block or character special file, dev is a configuration dependent 
specification of a character or block I/O device. If mode does not indicate a block special or 
character special device, dev is ignored. 

mknod may be invoked only by the super-user. 

RETURN VALUE 

Upon successful completion a value of is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

mknod will fail and the file mode will be unchanged if: 

[ENOTDIR] A component of the path prefix is not a directory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters. 

[ENOENT] A component of the path prefix does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EPERM] The process's effective user ID is not super-user. 

[EPERM] The pathname contains a character with the high-order bit set. 

[EIO] An I/O error occurred while making the directory entry or allocating the 

inode. 

The directory in which the entry for the new node is being placed can- 
not be extended because there is no space left on the file system con- 
taining the directory. 

There are no free inodes on the file system on which the node is being 
created. 

The directory in which the entry for the new node is being placed can- 
not be extended because the user's quota of disk blocks on the file sys- 
tem containing the directory has been exhausted. 

The user's quota of inodes on the file system on which the node is being 
created has been exhausted. 

The named file resides on a read-only file system. 

The named file exists. 

path points outside the process's allocated address space. 



[ENOSPC] 

[ENOSPCJ 
[EDQUOT] 

[EDQUOT] 

[EROFS] 

[EEXIST] 

[EFAULT] 
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SEE ALSO 

chmod(2) ? stat(2), umask(2) 



c 
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NAME 

mmap, munmap - map or unmap pages of memory 

SYNOPSIS 

#include <sys/mman.h> 
#include <sys/types.h> 

mmap(addr, len, prot, share, fd, off) 

caddr_t addr; 

int len, prot, share, fd; 

oflLt off; 

munmap (addr, len) 
caddr_Jt addr; 
int len; 

DESCRIPTION 

mmap maps pages of memory from the memory device associated with the file fd into the 
address space of the calling process, one page at a time. Pages are mapped from the memory 
device, beginning at off, and into the caller's address space, beginning at addr, and continuing 
for len bytes, fd is a file descriptor obtained by opening the device from which to map pages. 
Only character-special devices are currently supported. 

share specifies whether modifications made to mapped-in copies of pages are to be kept 
"private" or are to be "shared" with other references. Currently, it must be set to 
MAP_SHARED. 

The parameter prot specifies the read/write accessibility of the mapped pages. The addr and 
len parameters, and the sum of the current position in fd and off parameters, must be multi- 
ples of pagesize (found using the getpagesize(2) call). malloc(2) returns 4 properly aligned 
buffer if the request is for pagesize or larger bytes. 

Currently, only 1 device may be mapped by a process. The file descriptor must be closed to 
allow mapping of another device. 

All pages are automatically unmapped when fd is closed. Specific pages can be unmapped 
explicitly using munmap. 

mmap can sometimes be used to install memory-mapped devices without writing a device 
driver. However, this does not always work. In particular, devices that are mmap'ed into 
user space and then accessed by user programs will see those accesses in user mode. If the 
device contains registers that must be accessed in supervisor mode, mmap cannot be used to 
drive it. 

munmap unmaps previously mapped pages starting at addr and continuing for len bytes. 
Unmapped pages refer, once again, to private pages within the caller's address space. 
Unmapped pages are initialized to zero. 

RETURN VALUE 

Each call returns on success, -1 on failure. 

ERRORS 

Both calls fail when: 

EINVAL The argument address or length is not a multiple of the page size as 

returned by getpagesize(2), or the length is negative. 

EINVAL The entire range of pages specified in the call is not part of data space. 

In addition mmap fails when: 

EINVAL The specified fd does not refer to a character special device which 
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EINVAL 

EINVAL 
EINVAL 
SEE ALSO 



supports mapping (e.g. a frame buffer). 

The specified fd is not open for reading and read access is requested, or 
not open for writing when write access is requested. 

The sharing mode was not specified as MAP_SHARED. 

Another file mapped by mmap is open. 



( 



getpagesize(2), munmap(2), close(2), malloc(2) 



( 
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NAME 



mkdir - make a directory file 



SYNOPSIS 

mkdir (path 9 mode) 
char *path; 
int mode; 

DESCRIPTION 

mkdir creates a new directory file with name path . The mode of the new file is initialized 
from mode. (The protection part of the mode is modified by the process's mode mask; see 

uma$k(2)). 

The directory's owner ID is set to the process's effective user ID. The directory's group ID is 
set to that of the parent directory in which it is created. 

The low-order 9 bits of mode are modified by the process's file mode creation mask: all bits 
set in the process's file mode creation mask are cleared. See umask(2). 

RETURN VALUE 

A return value indicates success. A -1 return value indicates an error, and an error code is 
stored in errno. 



ERRORS 



mkdir will fail and no directory will be created if: 

[ENOTDIR] A component of the path prefix is not a directory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters. 

[ENOENT] A component of the path prefix does not exist. 

[EACCES] Search permission is denied for a component of the path prefix, 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EPERM] The path argument contains a byte with the high-order bit set. 

[EROFS] The named file resides on a read-only file system. 

[EEXIST] The named file exists. 

[ENOSPC] The directory in which the entry for the new directory is being placed 

cannot be extended because there is no space left on the file system con- 
taining the directory. 

[ENOSPC] The new directory cannot be created because there there is no space left 

on the file system that will contain the directory. 

[ENOSPC] There are no free inodes on the file system on which the directory is 

being created. 

[EDQUOT] The directory in which the entry for the new directory is being placed 

cannot be extended because the user's quota of disk blocks on the file 
system containing the directory has been exhausted. 

[EDQUOT] The new directory cannot be created because the user's quota of disk 

blocks on the file system that will contain the directory has been 
exhausted. 

[EDQUOT] The user's quota of inodes on the file system on which the directory is 

being created has been exhausted. 
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[EIO] An I/O error occurred while making, the directory entry or allocating the I 

inode. ^ 

[EIO] An I/O error occurred while reading from or writing to the file system. 

[EFAULT] path points outside the process's allocated address space. 

SEE ALSO 

chmod(2), stat(2), umask(2) 



( 
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NAME 

mount - mount file system 

SYNOPSIS 

#include <sys/mount.h> 

mount(type, dir, flags, data) 
int type; 
char *dir; 
int flags; 
caddr_t data; 

DESCRIPTION 

mount attaches a file system to a directory. After a successful return, references to directory 
dir will refer to the root directory on the newly mounted file system, dir is a pointer to a null- 
terminated string containing a path name, dir must exist already, and must be a directory. Its 
old contents are inaccessible while the file system is mounted. 

mount may be invoked only by the super-user. 

The flags argument determines whether the file system can be written on, and if set-uid execu- 
tion is allowed. Physically write-protected and magnetic tape file systems must be mounted 
read-only or errors willoccur when access times are updated, whether or not any explicit write 
is attempted. 

type indicates the type of the filesystem. It must be one of the types defined in mount. h . data 
is a pointer to a structure which contains the type specific arguments to mount. Below is a list 
of the filesystem types supported and the type specific arguments to each: 

MOUNTJUFS 

struct ufs_args { 

char *fspec; /* Block special file to mount */ 

}; 

MOUNT_NFS 

#include <nfs/nfs.h> 

#include < netinet/in .h > 
struct nfs_args { 

struct sockaddr_in *addr; /* file server address */ 

fhandle_t *fh; /* File handle to be mounted */ 

int flags; /* flags */ 

int wsize; /* write size in bytes */ 

int rsize; /* read size in bytes */ 

int timeo; /* initial timeout in ,1 sees */ 

int retrans; /* times to retry send */ 

}; 

RETURN VALUE 

mount returns if the action occurred, and -1 if fspec is inaccessible or not an appropriate 
file, if name does not exist, if fspec is already mounted, if dir is in use, or if there are already 
too many file systems mounted. 

ERRORS 

mount fails when one of the following occurs: 

EPERM The caller is not the super-user. 

ENOTBLK fspec is not a block device. 

ENXIO The major device number of fspec is out of range (this indicates no dev- 

ice driver exists for the associated hardware). 
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EBUSY 

EBUSY 

EBUSY 

EBUSY 
EIO 

ENOTDIR 

EINVAL 



dir is not a directory, or another process currently holds a reference to 
it. 

No space remains in the mount table. 

The super block for the file system had a bad magic number or an out 
of range block size. 

Not enough memory was available to read the cylinder group informa- 
tion for the file system. 

An I/O error occurred while reading the super block or cylinder group 
information. 

A component of the path prefix in f spec or dir is not a directory. 

The path name of fspec or dir contains a character with the high-order 
bit set. 



ENAMETOOLONG The length of a component of the path name of fspec or dir exceeds 255 
characters, or the length of the entire path name of fspec or dir exceeds 
1023 characters. 



ENOENT 

ENOTDIR 

EACCES 



fspec or dir does not exist. 

The file named by dir is not a directory. 

Search permission is denied for a component of the path prefix of fspec 
or dir. 



EFAULT fspec or dir points outside the process's allocated address space. 

ELOOP Too many symbolic links were encountered in translating the path name 

of fspec or dir . 

EIO An I/O error occurred while reading from or writing to the file system. 

SEE ALSO 

unmount(2), mount(8) 

WARNING 

The error codes are in a state of disarray; too many errors appear to the caller as one value. 



( 



( 
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NAME 

nfssvc, async_daemon - NFS daemons 

SYNOPSIS 

nfssvc(sock) 
int sock; 

async__daemon 

DESCRIPTION 

nfssvc starts an NFS daemon listening on socket sock. The socket must be AFJNET, and 
SOCKJDGRAM (protocol UDP/IP). The system call will return only if the process is killed. 

async_4aemon implements the NFS daemon that handles asynchronous I/O for an NFS client. 
The system call never returns. 

WARNING 

These two system calls allow kernel processes to have user context. 

SEE ALSO 

mountd(8) 
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NAME 

open - open a file for reading or writing, or create a new file 

SYNOPSIS 

#include <$ys/file,h> 

open (path 3 flags, mode) 
char *path; 
int flags, mode; 

DESCRIPTION 

open opens the file path for reading and/or writing, as specified by the flags argument and 
returns a descriptor for that file. The flags argument may indicate the file is to be created if it 
does not already exist (by specifying the O.XREAT flag), in which case the file is created with 
mode mode as described in chmod(2) and modified by the process' umask value (see 
umask(2)). 

path is the address of a string of ASCII characters representing a path name, terminated by a 
null character. The flags specified are formed by or'ing the following values 

OJRDONLY open for reading only OJWRONLY open for writing only 

0_RDWR open for reading and writing OJNFDELAY do not block on open 

0_APPEND append on each write O^CREAT create file if it does not 

OJTRUNC truncate size to OJEXCL error if create and file exists 

Opening a file with CLAPPEND set causes each write on the file to be appended to the end. If 
0_JRUNC is specified and the file exists, the file is truncated to zero length. If OJBXCL is set 
with CLCREAT, then if the file already exists, the open returns an error. This can be used to 
implement a simple exclusive access locking mechanism. If OJBXCL is set and the last com- 
ponent of the pathname is a symbolic link, the open will fail even if the symbolic link points 
to a non-existent name. If the 0_NDELA Y 

flag is specified and the open call would result in the process being blocked for some reason 
(e.g. waiting for carrier on a dialup line), the open returns immediately. The first time the pro- 
cess attempts to perform i/o on the open file it will block (not currently implemented). 

Upon successful completion a non-negative integer termed a file descriptor is returned. The 
file pointer used to mark the current position within the file is set to the beginning of the file. 

The new descriptor is set to remain open across execve system calls; see close (2). 

The system imposes a limit on the number of file descriptors open simultaneously by one pro- 
cess, getdtablesize (2) returns the current system limit, 

ERRORS 

The named file is opened unless one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory, 

[EINVAL] The pathname contains a character with the high-order bit set, 

[ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters. 

[ENOENT] CLCREAT is not set and the named file does not exist. 

[ENOENT] A component of the path name that must exist does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[EACCES] The required permissions (for reading and/or writing) are denied for the 

named flag. 

[EACCES] O^CREAT is specified, the file does not exist, and the directory in which 

it is to be created does not permit writing. 
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[ELOOP] 
[EISDIR] 

[EROFS] 

[EMFILE] 

[ENFILE] 
[ENXIO] 

[ENOSPC] 

[ENOSPC] 
[EDQUOT] 

[EDQUOT] 

[EIO] 

[ETXTBSY] 

[EFAULT] 

[EEXXST] 

[EOPNOTSUPP] 



Too many symbolic links were encountered in translating the pathname. 

The named file is a directory, and the arguments specify it is to be 
opened for writting. 

The named file resides on a read-only file system, and the file is to be 
modified. 

The system limit for open file descriptors per process has already been 
reached. 

The system file table is full. 

The named file is a character special or block special file, and the dev- 
ice associated with this special file does not exist. 

0__CREAT is specified, the file does not exist, and the directory in which 
the entry for the new file is being placed cannot be extended because 
there is no space left on the file system containing the directory. 

Q_CREAT is specified, the file does not exist, and there are no free 
inodes on the file system on which the file is being created. 

0_CREAT is specified, the file does not exist, and the directory in which 
the entry for the new fie is being placed cannot be extended because the 
user's quota of disk blocks on the file system containing the directory 
has been exhausted. 

O.CREAT is specified, the file does not exist, and the user's quota of 
inodes on the file system on which the file is being created has been 
exhausted. 

An I/O error occurred while making the directory entry or allocating the 
inode for 0_CREAT. 

The file is a pure procedure (shared text) file that is being executed and 
the open call requests write access. 

path points outside the process's allocated address space. 

O.CREAT and OJEXCL were specified and the file exists. 

An attempt was made to open a socket (not currently implemented). 



SEE ALSO 

chmod(2), close(2), dup(2), getdtablesize(2), lseek(2), read(2), write(2), umask(2) 
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NAME 

pipe - create an interprocess communication channel 

SYNOPSIS 

pipe (tildes) 
Int fiides [2]; 

DESCRIPTION 

The pipe system call creates an I/O mechanism called a pipe. The file descriptors returned can 
be used in read and write operations. When the pipe is written using the descriptor fildes[l] 
up to 4096 bytes of data are buffered before the writing process is suspended. A read using 
the descriptor fildes[0] will pick up the data. 

It is assumed that after the pipe has been set up, two (or more) cooperating processes (created 
by subsequent fork calls) will pass data through the pipe with read and write calls. 

The shell has a syntax to set up a linear array of processes connected by pipes. 

Read calls on an empty pipe (no buffered data) with only one end (all write file descriptors 
closed) returns an end-of-file. 

Pipes are really a special case of the socketpair(2) call and, in fact, are implemented as such in 
the system. 

A signal is generated if a write on a pipe with only one end is attempted, 

RETURN VALUE 

The function value zero is returned if the pipe was created; -1 if an error occurred. 

ERRORS 

The pipe call will fail if: 

[EMFILE] Too many descriptors are active. 

[ENFILE] The system file table is full. 

[EFAULT] The fiides buffer is in an invalid area of the process's address space. 

SEE ALSO 

sh(l), read(2), write(2), fork(2), socketpair(2) 

WARNING 

Should more than 4096 bytes be necessary in any pipe among a loop of processes, deadlock 
will occur. 



c 



( 
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NAME 

profil - execution time profile 

SYNOPSIS 

profil (buff, bufsiz, offset, scale) 

char *buff; 

int bufsiz 9 offset, scale; 

DESCRIPTION 

buff points to an area of core whose length (in bytes) is given by bufsiz . After this call, the 
user's program counter (pc) is examined each clock tick (10 milliseconds); offset is subtracted 
from it, and the result multiplied by scale. If the resulting number corresponds to a word 
inside buff, that word is incremented. 

The scale is interpreted as an unsigned, fixed-point fraction with 16 bits of fraction: 0x10000 
gives a 1-1 mapping of pc's to words in buff; 0x8000 maps each pair of instruction words 
together. 

Profiling is turned off by giving a scale of or 1. It is rendered ineffective by giving a bufsiz of 
0. Profiling is turned off when an execve is executed, but remains on in child and parent both 
after a fork . Profiling is turned off if an update in buff would cause a memory fault. 

RETURN VALUE 

A 0, indicating success, is always returned. 

SEE ALSO 

gprof(l), setitimer(2), monitor(3) 
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NAME 

ptrace - process trace 

SYNOPSIS 

#include <signal.h> 
#include <$ys/ptrace.h> 

ptrace (request, pid, addr, data) 
int request, pid 9 *addr, data; 

DESCRIPTION 

ptrace provides a means' by which a process may control the execution of another process, and 
examine and change its core image. Its primary use is for the implementation of breakpoint 
debugging. There are four arguments whose interpretation depends on a request argument. 
Generally, pid is the process ID of the traced process. A process being traced behaves nor- 
mally until it encounters some signal whether internally generated like "illegal instruction" or 
externally generated like "interrupt". See sigvec(2) for the list. 

Upon encountering a signal the traced process enters a stopped state and its tracing process is 
notified via wait(2). If the the traced process stops with a SIGTRAP the process may have 
been stopped for a number of reasons. Two status words addressable as registers in the 
traced process's uarea qualify SIGTRAPs: TRAPCAUSE, which contains the cause of the trap, 
and TRAPINFO, which contains extra information concerning the trap. 

When the traced process is in the stopped state, its core image can be examined and modified 
using ptrace. If desired, another ptrace request can then cause the traced process either to ter- 
minate or to continue, possibly ignoring the signal. 

The value of the request argument determines the precise action of the call: 

This request is the only one that may be used by a child process; it may declare that it is I 

to be traced by its parent. All other arguments are ignored. Peculiar results will ensue if ^ 

the parent does not expect to trace the child. 

1,2 The word in the traced process's address space at addr is returned. If I and D space are 
separated (e.g. historically on a pdp-11), request 1 indicates I space, 2 D space, addr 
must be 4~byte aligned. The traced process must be stopped. The input data is ignored. 

3 The word of the system's per-process data area corresponding to addr is returned, addr is 
a constant defined in sys/ptrace.h. This space contains the registers and other informa- 
tion about the process; the constants correspond to fields in the user structure in the sys- 
tem. 

4,5 The given data is written at the word in the process's address space corresponding to 
addr, which must be 4-byte aligned. The old value at the address is returned. If I and D 
space are separated, request 4 indicates I space, 5 D space. Attempts to write in pure 
procedure fail if another process is executing the same file. 

6 The process's system data is written, as it is read with request 3. Only a few locations can 
be written in this way: the general registers, the floating point status and registers, and cer- 
tain bits of the processor status word. The old value at the address is returned. 

7 The data argument is taken as a signal number and the traced process's execution contin- 
ues at location addr as if it had incurred that signal. Normally the signal number will be 
either to indicate that the signal that caused the stop should be ignored, or that value 
fetched out of the process's image indicating which signal caused the stop. If addr is (int 
*)X then execution continues from where it stopped, 

8 The traced process terminates. 

9 Execution continues as in request 7; however, as soon as possible after execution of at | 
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least one instruction, execution stops again. The signal number from the stop is 
SIGTRAP. TRAPCAUSE will contain CAUSESINGLE. This is part of the mechanism for 
implementing breakpoints. 

As indicated, these calls (except for request and 20) can be used only when the subject pro- 
cess has stopped. The wait call is used to determine when a process stops; in such a case the 
"termination" status returned by wait has the value 0177 to indicate stoppage rather than 
genuine termination. If multiple processes are being traced, wait can be called multiple times 
and will return the status for the next stopped or terminated child or traced process. 

To forestall possible fraud, ptrace inhibits the set-user-id and set-group-id facilities on subse- 
quent execve(2) calls. If a traced process calls execve, it will stop before executing the first 
instruction of the new image showing signal SIGTRAP. In this case TRAPCAUSE will contain 
CAUSEEXEC and TRAPINFO will not contain anything interesting. If a traced process execs 
again, the same thing will happen. 

If a traced process forks, both parent and child will be traced. Breakpoints from the parent 
will not be copied into the child. At the time of the fork, the child will be stopped with a 
SIGTRAP. The tracing process may then terminate the trace if desired. TRAPCAUSE will con- 
tain CAUSEFORK and TRAPINFO will contain the pid of its parent. 

RETURN VALUE 

A value is returned if the call .succeeds. If the call fails then a -1 is returned and the global 
variable errno is set to indicate the error. 

ERRORS 

[EINVAL] The request code is invalid. 

[EINVAL] The specified process does not exist. 

[EINVAL] The given signal number is invalid. 

[EFAULT] The specified address is out of bounds. 

[EPERM] The specified process cannot be traced. 

SEE ALSO 

wait(2), sigvec(2), adb(l) 



BUGS 



ptrace is unique and arcane; it should be replaced with a special file which can be opened and 
read and written. The control functions could then be implemented with ioctl(2) calls on this 
file. This would be simpler to understand and have much higher performance. 

The request call should be able to specify signals which are to be treated normally and not 
cause a stop. In this way, for example, programs with simulated floating point (which use 
"illegal instruction" signals at a very high rate) could be efficiently debugged. 

The error indication, -1, is a legitimate function value; errno, see intro(2), can be used to 
disambiguate. 

It should be possible to stop a process on occurrence of a system call; in this way a com- 
pletely controlled environment could be provided. 
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NAME 



quota - manipulate disk quotas 



SYNOPSIS 

#include <sys/quota.h> 

quota (cmd ? uid, arg, addr) 
int cmd, uid 9 arg; 
caddr_t addr; 

DESCRIPTION 

N.B.: This call is not implemented in the current version of the system. 

The quota call manipulates disk quotas for file systems which have had quotas enabled with 
setquota(2). The cmd parameter indicates a command to be applied to the user ID uid. arg is 
a command specific argument and addr is the address of an optional, command specific, data 
structure which is copied in or out of the system. The interpretation of arg and addr is given 
with each command below. 

CL.SETDLIM Set disc quota limits and current usage for the user with ID uid. arg is a 

major-minor device indicating a particular file system, addr is a pointer 
to a struct dqblk structure (defined in <syslquota.h>). This call is res- 
tricted to the super-user. 

Q_GETDLIM Get disc quota limits and current usage for the user with ID uid. The 

remaining parameters are as for CLSETDLIM. 

Q_SETDUSE Set disc usage limits for the user with ID uid. arg is a major-minor dev- 

ice indicating a particular file system, addr is a pointer to a struct 
dqusage structure (defined in <sys/quota.h>). This call is restricted to 
the super-user. 

OLSYNC Update the on-disc copy of quota usages. The uid, arg, and addr 

parameters are ignored. 

CLSETUID Change the calling process's quota limits to those of the user with ID 

uid. The arg and addr parameters are ignored. This call is restricted to 
the super-user. 

Q.SETWARN Alter the disc usage warning limits for the user with ID uid. arg is a 

major-minor device indicating a particular file system, addr is a pointer 
to a struct dqwarn structure (defined in <syslquota.h>). This call is 
restricted to the super-user. 

QJDOWARN Warn the user with user ID uid about excessive disc usage. This call 

causes the system to check its current disc usage information and print a 
message on the terminal of the caller for each file system on which the 
user is over quota. If the arg parameter is specified as NODEV, all file 
systems which have disc quotas will be checked. Otherwise, arg indi- 
cates a specific major-minor device to be checked. This call is restricted 
to the super-user. 

RETURN VALUE 

A successful call returns and, possibly, more information specific to the cmd performed; 
when an error occurs, the value -1 is returned and errno is set to indicate the reason. 



ERRORS 



A quota call will fail when one of the following occurs: 

[EINVAL] Cmd is invalid. 

[ESRCH] No disc quota is found for the indicated user. 



c 



( 
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[EPERM] 

[EINVAL] 

[EFAULT] 



The call is priviledged and the caller was not the super-user. 

The arg parameter is being interpreted as a major-minor device and it 
indicates an unmounted file system. 

An invalid addr is supplied; the associated structure could not be copied 
in or out of the kernel. 

The quota table is full. 



[EUSERS] 

SEE ALSO 

setquota(2), quotaon(8), quotacheck(8) 

BUGS 

There should be someway to integrate this call with the resource limit interface provided by 
setrlimit(2) and getrlimit(2). 

The Australian spelling of disk is used throughout the quota facilities in honor of the imple- 
mentors. 
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NAME 

quotactl - manipulate disk quotas 

SYNOPSIS 

#include <ufs/<|uota.h> 

quotactl (cmd, special, uid, addr) 
int cmd; 
char *special; 
int uid; 
caddr__t addr; 

DESCRIPTION 

The quotactl call manipulates disk quotas. The cmd parameter indicates a command to be 
applied to the user ID uid. special is a pointer to a null-terminated string containing the path 
name of the block special device for the file system being manipulated. The block special 
device must be mounted, addr is the address of an optional, command specific, data struc- 
ture which is copied in or out of the system. The interpretation of addr is given with each 
command below. 



c 



(XQUOTAON 



CLQUOTAOFF 



QJ3ETQU0TA 



Q_SETQUOTA 



<X_SETQLIM 



Q„SYNC 



Turn on quotas for a file system, addr is a pointer to a null terminated 
string containing the path name of file containing the quotas for the file 
system. The quota file must exist; it is normally created with the quota™ 
check(8) program. This call is restricted to the super-user. 

Turn off quotas for a file system. This call is restricted to the super- 
user. 

Get disk quota limits and current usage for user uid . addr is a pointer 
to a struct dqblk structure (defined in <uf si quota. h>). Only the super- 
user may get the quotas of a user other than himself. 

Set disk quota limits and current usage for user uid. addr is a pointer to 
a struct dqblk structure (defined in <ufs/quota.h>). This call is res- 
tricted to the super-user. 

Set disk quota limits for user uid. addr is a pointer to a struct dqblk 
structure (defined in <ufs/quota.h>). This call is restricted to the 
super-user. 

Update the on-disk copy of quota usages. This call is restricted to the 
super-user. 



RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

ERRORS 

A quotactl call will fail when one of the following occurs: 



EINVAL 
EPERM 

EINVAL 

ENOTBLK 

EFAULT 

EINVAL 



cmd is invalid. 

The call is privileged and the caller was not the super-user. 

The special parameter is not a mounted file system or is a mounted file 
system without quotas enabled. 

The special parameter is not a block device. 

An invalid addr is supplied; the associated structure could not be copied 
in or out of the kernel. 

The addr parameter is being interpreted as the path of a quota file 
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which exists but is either not a regular file or is not on the file system 
pointed to by the special parameter. 

EUSERS The quota table is full. 

SEE ALSO 

quotaon(8) ? quotacheck(8) 

BUGS 

There should be some way to integrate this call with the resource limit interface provided by 
setrlimit(2) and getrlimit(2). Incompatible with Melbourne quotas. 
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NAME I 

read, readv - read input V 

SYNOPSIS 

cc s: read(d 9 buf, wbytes) 
int cc, d; 
char *buf; 

int nbytes; 

#mclude <sys/types.h> 
#ineliide <sys/uio.h> 

cc = readv(d, iov, iovcnt) 

int cc, d; 

struct iovec *iov; 

int Iovcnt; 

DESCRIPTION 

read attempts to read nbytes of data from the object referenced by the descriptor d into the 
buffer pointed to by buf. readv performs the same action, but scatters the input data into the 
iovcnt buffers specified by the members of the iov array: iov[0], iov[l], ..., iovfiovcnt - 1]. 

For readv, the iovec structure is defined as 

struct iovec { 

caddr__t iov^base; 
int iov Jen; 

}; 

Each iovec entry specifies the base address and length of an area in memory where data should ^ 

be placed, readv will always fill an area completely before proceeding to the next. I 

On objects capable of seeking, the read starts at a position given by the pointer associated 
with d (see lseek(2)). Upon return from read, the pointer is incremented by the number of 
bytes actually read. 

Objects that are not capable of seeking always read from the current position. The value of 
the pointer associated with such an object is undefined. 

Upon successful completion, read and readv return the number of bytes actually read and 
placed in the buffer. The system guarantees to re^d the number of bytes requested if the 
descriptor references a normal file that has that many bytes left before the end-of-file, but in 
no other case. 

If the returned value is 0, then end-of-file has been reached, 

RETURN VALUE 

If successful, the number of bytes actually read is returned, Otherwise, a -1 is returned and 
the global variable errno is set to indicate the error. 

ERRORS 

read and readv will fail if one or more of the following are true: 

[EBADF] D is not a valid file or socket descriptor open for reading. 

[EFAULT] buf points outside the allocated address space, 

[EIO] An I/O error occurred while reading from the file system. 

[EINTR] A read from a slow device was interrupted before any data arrived by 

the delivery of a signal. 

[EINVAL] The pointer associated with d was negative. 



( 
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[EWOULDBLOCK] The file was marked for non-blocking I/O, and no data were ready to be 
read. 

In addition, readv may return one of the following errors: 

[EINVAL] iovcnt was less than or equal to 0, or greater than 16. 

[EINVAL] One of the iovjen values in the iov array was negative. 

[EINVAL] The sum of the iovjen values in the iov array overflowed a 32-bit 

integer. 

[EFAULT] Part of the iov points outside the process's allocated address space. 

SEE ALSO 

dup(2), fcntl(2), open (2), pipe(2), select(2), socket(2), socketpair(2) 
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NAME f 

readlink - read value of a symbolic link ^ 

SYNOPSIS 

cc 5S readlink(path, bwf, bwfsije) 

int cc; 

char *path, *buf; 

int bufsiz; 

DESCRIPTION 

readlink places the contents of the symbolic link name in the buffer buf, which has size buf$iz* 
The contents of the link are not null terminated when returned, 

RETURN VALUE 

The call returns the count of characters placed in the buffer if it succeeds ? or a -1 if an error 
occurs, placing the error code in the global variable errno. 

ERRORS 

readlink will fail and the file mode will be unchanged if: 

[ENOTDIR] A component of the path prefix is not a directory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] , A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EINVAL] The named file is not a symbolic link. 

[EIO] An I/O error occurred while reading from the file system. 

[EFAULT] buf extends outside the process's allocated address space. 

SEE ALSO 

$tat(2), lstat(2), symlink(2) 



( 
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NAME 

reboot - reboot system or halt processor 

SYNOPSIS 

#include <sys/reboot.h> 

reboot(howto) 
int howto; 

DESCRIPTION 

reboot reboots the system, and is invoked automatically in the event of unrecoverable system 
failures, howto is a mask of options passed to the bootstrap program. The system call inter- 
face permits only RBJHALT or RB^AUTOBOOT to be passed to the reboot program; the other 
flags are used in scripts stored on the console storage media, or used in manual bootstrap pro- 
cedures. When none of these options (e.g. RB_AUTOBOOT ) is given, the system is rebooted 
from file "vmunix" in the root file system of unit of a disk chosen in a processor specific 
way. An automatic consistency check of the disks is then normally performed. 

The bits of howto are: 

RB_HALT the processor is simply halted; no reboot takes place. RB_HALT should 

be used with caution. 

RB.ASKNAME Interpreted by the bootstrap program itself, causing it to inquire as to 

what file should be booted. Normally, the system is booted from the 
file "xx(0,0)vmunix" without asking. 

RB^SINGLE Normally, the reboot procedure involves an automatic disk consistency 

check and then multi-user operations. RB_SINGLE prevents the con- 
sistency check, rather simply booting the system with a single-user shell 
on the console. RB_SINGLE is interpreted by the init(8) program in the 
newly booted system. This switch is not available from the system call 
interface. 

Only the super-user may reboot a. machine. 

RETURN VALUES 

If successful, this call never returns. Otherwise, a -1 is returned and an error is returned in 
the global variable errno . 

ERRORS 

[EPERM] The caller is not the super-user. 

SEE ALSO 

crash(8), halt(8), init(8), reboot(8) 

BUGS 

The notion of "console medium", among other things, is specific to the VAX. 
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NAME 

recv, recvfrom, recvmsg - receive a message from a socket 



( 



SYNOPSIS 

#include <sys/types.h> 
#include <sys/socket.h> 

cc s recv($, buf, len, flags) 
int cc, s; 
char *buf; 
Int len, flags; 

cc s recyfrom($, buf, len, flags, from, fromlen) 

int cc, s; 

char *huf; 

int len, flags; 

street sockaddr #from; 

int *fromlen; 

cc s= recvm$g(s, msg, flags) 
int cc, s; 

struct msghdr msgQ; 
int flags; 

DESCRIPTION 

recv, recv from, and recvmsg are used to receive messages from a socket. 

The recv call is normally used only on a connected socket (see connect (2)), while recvfrommA 
recvmsg may be used to receive data on a socket whether it is in a connected state or not. 

If from is non-zero, the source address of the message is filled in. Fromlen is a value-result I 

parameter, initialized to the size of the buffer associated with from, and modified on return to 
indicate the actual size of the address stored there. The length of the message is returned in 
cc. If a message is too long to fit in the supplied buffer, excess bytes may be discarded 
depending on the type of socket the message is received from (see socket (7)), 

If no messages are available at the socket, the receive call waits for a message to arrive, unless 
the socket is nonblocking (see ioctl(2)) in which case a cc of -1 is returned with the external 
variable errno set to EWOULDBLOCK. 

The select(2) call may be used to determine when more data arrives. 

The flags argument to a recv call is formed by or'ing one or more of the values, 

#define MSG_X)OB Oxl /* process out-of-band data */ 

#define MSGJPEEK 0x2 /* peek at incoming message */ 

The recvmsg call uses a msghdr structure to minimize the number of directly supplied parame- 
ters. This structure has the following form, as defined in <sy si socket, h> : 

struct msghdr { 

caddr„t msgjiame; /* optional address */ 

int msg^namelen; /* size of address */ 

struct iovec *msgJov; /* scatter/gather array */ 

int msgjovlen; /* # elements in msgjov */ 

caddr_tmsg_accrights; /* access rights sent/received */ 
int msg_accrightslen; 



}; 



( 
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Here msgjname and msg_namelen specify the destination address if the socket is unconnected; 
msg_name may be given as a null pointer if no names are desired or required. The msgjov 
and msgjovlen describe the scatter gather locations, as described in read (2). A buffer to 
receive any access rights sent along with the message is specified in msgjaccrights , which has 
length msguaccrightslen . Access rights are currently limited to file descriptors, which each 
occupy the size of an int. 

RETURN VALUE 

These calls return the number of bytes received, or -1 if an error occurred. 

ERRORS 

The calls fail if: 



[EBADF] The argument s is an invalid descriptor. 



[ENOTSOCK] 



The argument $ is not a socket. 



[EWOULDBLOCK] The socket is marked non-blocking and the receive operation would 
block. 



[EINTR] 
[EFAULT] 



The receive was interrupted by delivery of a signal before any data was 
available for the receive. 

The data was specified to be received into a non-existent or protected 
part of the process address space. 



SEE ALSO 

fcntl(2), read(2), send(2), select(2), getsockopt(2), socket(2) 
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NAME 

rename - change the name of a file 

SYNOPSIS 

rename (from 9 to) 
char *from, *to; 

DESCRIPTION 

rename causes the link named from to be renamed as to. If to exists, then it is first removed . 
Both from and to must be of the same type (that is, both directories or both non-directories), 
and must reside on the same file system. 

rename guarantees that an instance of to will always exist, even if the system should crash in 
the middle of the operation. 

K the final component of from is a symbolic link, the symbolic link is renamed, not the file or 
directory to which it points. 

CAVEAT 

The system can deadlock if a loop in the file system graph is present. This loop takes the 
form of an entry in directory "a", say "a/foo", being a hard link to directory "b", and an 
entry in directory "b", say "b/bar", being a hard link to directory "a". When such a loop 
exists and two separate processes attempt to perform "rename a/foo b/bar" and "rename 
b/bar a/foo", respectively, the system may deadlock attempting to lock both directories for 
modification. Hard links to directories should be replaced by symbolic links by the system 
administrator. 

RETURN VALUE 

A value is returned if the operation succeeds, otherwise rename returns -1 and the global 
variable errno indicates the reason for the failure. 

ERRORS 

rename will fail and neither of the argument files will be affected if any of the following are 
true: 

[EINVAL] Either pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of either pathname exceeded 255 characters, or the entire 
length of either path name exceeded 1023 characters. 

[ENOENT] A component of the from path does not exist, or a path prefix of to 

does not exist. 

[EACCES] A component of either path prefix denies search permission. 

[EACCES] The requested link requires writing in a directory with a mode that 

denies write permission. 

[EPERM] The directory containing from is marked sticky, and neither the contain- 

ing directory nor from are owned by the effective user ID. 

[EPERM] The to file exists, the directory containing to is marked sticky, and nei- 

ther the containing directory nor to are owned by the effective user ID. 

[ELOOP] Too many symbolic links were encountered in translating either path- 

name. 

[ENOTDIR] A component of either path prefix is not a directory. 

[ENOTDIR] from is a directory, but to is not a directory. 

[EISDIR] to is a directory, but from is not a directory. 

[EXDEV] The link named by to and the file named by from are on different logical 
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[ENOSPC] 

[EDQUOT] 

[EIO] 
[EROFS] 

[EFAULT] 
[EINVAL] 



devices (file systems). Note that this error code will not be returned if 
the implementation permits cross-device links. 

The directory in which the entry for the new name is being placed can- 
not be extended because there is no space left on the file system con- 
taining the directory. 

The directory in which the entry for the new name is being placed can- 
not be extended because the user's quota of disk blocks on the file sys- 
tem containing the directory has been exhausted. 

An I/O error occurred while making or updating a directory entry. 

The requested link requires writing in a directory on a read-only file sys- 
tem. 

path points outside the process's allocated address space. 
from is a parent directory of to, or an attempt is made to rename "."or 



[ENOTEMPTY] 

SEE ALSO 

open(2) 



to is a directory and is not empty. 
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NAME 



rmdir - remove a directory file 



( 



SYNOPSIS 

rmdir (path) 
char *paih; 

DESCRIPTION 

rmdir removes a directory file whose name is given by path. The directory must not have any 
entries other than "." and "..", 

RETURN VALUE 

A is returned if the remove succeeds; otherwise a -1 is returned and an error code is stored 
in the global location errno . 

ERRORS 

The named file is removed unless one or more of the following are true: 

[ENOTDIR] A component of the path is not a directory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters, 

The named directory does not exist. 

Too many symbolic links were encountered in translating the pathname. 

The named directory contains files other than "." and ".." in it. 

Search permission is denied for a component of the path prefix. 

Write permission is denied on the directory containing the link to be 
removed. 

The directory containing the directory to be removed is marked sticky, 
and neither the containing directory nor the directory to be removed are 
owned by the effective user ID. 

The directory to be removed is the mount point for a mounted file sys- 
tem. 

An I/O error occurred while deleting the directory entry or deallocating 
the inode. 

The directory entry to be removed resides on a read-only file system. 

path points outside the process's allocated address space. 



[ENOENT] 

[ELOOP] 

[ENOTEMPTY] 

[EACCES] 

[EACCES] 

[EPERM] 

[EBUSY] 
[EIO] 



[EROFS] 

[BFAULT] 

SEE ALSO 

mkdir(2), unlink(2) 
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NAME 

select - synchronous I/O multiplexing 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/time.h> 

nfound = select(nfds, readfds, writefds, exceptfds, timeout) 

int nfound, nfds; 

£d__set *readfd$, *writefds, *exceptfds; 

struct timeyal *timeout; 

FD_SET(fd, &fdset) 

FD_CLR(fd, Afdset) 
FDJSS£T(fd, Afdset) 
FD„ZERO(&fdset) 
int fd; 
fd_set fdset; 

DESCRIPTION 

select examines the I/O descriptor sets whose addresses are passed in readfds, writefds, and 
exceptfds to see if some of their descriptors are ready for reading, are ready for writing, or 
have an exceptional condition pending, respectively, The first nfds descriptors are checked in 
each set; i.e. the descriptors from through nfds -1 in the descriptor sets are examined. On 
return, select replaces the given descriptor sets with subsets consisting of those descriptors that 
are ready for the requested operation. The total number of ready descriptors in all the sets is 
returned in nfound. 

The descriptor sets are stored as bit fields in arrays of integers. The following macros are pro- 
vided for manipulating such descriptor sets; * FDJZERO(&fdset)" initializes a descriptor set 

fdset to the null set. FD_$ET(fd, &fdset) includes a particular descriptor fd in fdset. 
FD_CLR(fd, &fdset) removes fd from fdset. FDJSSET(fd, &fdset) is nonzero if fd is a member 
of fdset, zero otherwise. The behavior of these macros is undefined if a descriptor value is 
less than zero or greater than or equal to FDJSETSIZE, which is normally at least equal to the 
maximum number of descriptors supported by the system. 

If timeout is a non-zero pointer, it specifies a maximum interval to wait for the selection to 
complete. If timeout is a zero pointer, the select blocks indefinitely. To affect a poll, the 
timeout argument should be non-zero, pointing to a zero-valued timeval structure. 

Any of readfds, writefds, and exceptfds may be given as zero pointers if no descriptors are of 
interest. 

RETURN VALUE 

select returns the number of ready descriptors that are contained in the descriptor sets, or -1 
if an error occurred. If the time limit expires then select returns 0. If select returns with an 
error, including one due to an interrupted call, the descriptor sets will be unmodified. 

ERRORS 

An error return from select indicates: 

[EBADF] One of the descriptor sets specified an invalid descriptor. 

[EINTR] A signal was delivered before the time limit expired and before any of 

the selected events occurred. 

[EINVAL] The specified time limit is invalid. One of its components is negative or 

too large. 
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SEE ALSO 

accept(2), connect(2), read(2), write(2), recv(2), send(2), getdtablesize(2) 

BUGS 

Although the provision of getdtahlesize(2) was intended to allow user programs to be written 
independent of the kernel limit on the number of open files, the dimension of a sufficiently 
large bit field for select remains a problem. The default size FD^SETSIZE (currently 256) is 
somewhat larger than the current kernel limit to the number of open files. However, in order 
to accommodate programs which might potentially use a larger number of open files with 
select, it is possible to increase this size within a program by providing a larger definition of 
FD_SETSIZE before the inclusion of <sys/types.h>. 

select should probably return the time remaining from the original timeout, if any, by modify- 
ing the time value in place. This may be implemented in future versions of the system. Thus, 
it is unwise to assume that the timeout value will be unmodified by the select call. 



( 
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NAME 

send, sendto, sendmsg - send a message from a socket 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/socket.h> 

cc = send(s, msg, len, flags) 
int cc, s; 
char *msg; 
int len, flags; 

cc ~ sendto (s, msg, len, flags, to, tolen) 

bit cc, s; 

char *msg; 

int len, flags; 

struct sockaddr *to; 

int tolen; 

cc = sendmsg (s, msg, flags) 

int cc, s; 

struct msghdr msgQ; 

int flags; 

DESCRIPTION 

send, sendto, and sendmsg are used to transmit a message to another socket, send may be 
used only when the socket is in a connected state, while sendto and sendmsg may be used at 
any time. 

The address of the target is given by to with tolen specifying its size. The length of the mes- 
sage is given by len . If the message is too long to pass atomically through the underlying pro- 
tocol, then the error EMSGSIZE is returned, and the message is not transmitted. 

No indication of failure to deliver is implicit in a send. Return values of -1 indicate some 
locally detected errors. 

If no messages space is available at the socket to hold the message to be transmitted, then 
send normally blocks, unless the socket has been placed in non-blocking I/O mode. The 
select(2) call may be used to determine when it is possible to send more data. 

The flags parameter may include one or more of the following; 

#define MSG_OOB Oxl /* process out-of-band data */ 

#define MSGJDONTROUTE 0x4 /* bypass routing, use direct interface */ 
The flag MSG_OOB is used to send "out-of-band" data on sockets that support this notion 
(e.g. SOCELSTREAM); the underlying protocol must also support "out-of-band" data. 
MSGJDONTROUTE is usually used only by diagnostic or routing programs. 

See recv(2) for a description of the msghdr structure. 

RETURN VALUE 

The call returns the number of characters sent, or -1 if an error occurred. 

ERRORS 

[EBADF] An invalid descriptor was specified. 

[ENOTSOCK] The argument s is not a socket. 

[EFAULT] An invalid user space address was specified for a parameter. 

[EMSGSIZE] The socket requires that message be sent atomically, and the size of the 

message to be sent made this impossible. 
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[EWOULDBLOCK] The socket is marked non-blocking and the requested operation would 
block. 

[ENOBUFS] The system was unable to allocate an internal buffer. The operation 

may succeed when buffers become available. 

[ENOBUFS] The output queue for a network interface was full. This generally indi- 

cates that the interface has stopped sending, but may be caused by tran- 
sient congestion. 

SEE ALSO 

fcntl(2), recv(2), select(2), getsockopt(2), socket(2), write(2) 



( 
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NAME 

setgroups - set group access list 

SYNOPSIS 

#include <sys/param.h> 

setgroups(ngroups, gidset) 
int ngroups, *gidset; 

DESCRIPTION 

setgroups sets the group access list of the current user process according to the array gidset. 
The parameter ngroups indicates the number of entries in the array and must be no more than 
NGROUPS, as defined in <sy$/par(im.h>. 

Only the super-user may set new groups. 

RETURN VALUE 

A value is returned on success, -1 on error, with a error code stored in ermo, 

ERRORS 

The setgroups call will fail if: 

[EPERM] The caller is not the super-user. 

[EFAULT] The address specified for gidset is outside the process address space. 

SEE ALSO 

getgroups(2), initgroups(3X) 

BUGS 

The gidset array should be of type gi«L.t, but remains integer for compatibility with earlier sys- 
tems. 
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NAME 

setpgrp - set process group 

SYNOPSIS 

setpgrp (pid, pgrp) 
int pid, pgrp; 

DESCRIPTION 

setpgrp sets the process group of the specified process pid to the specified pgrp. lipid is zero, 
then the call applies to the current process. 

If the invoker is not the super-user, then the affected process must have the same effective 
user4d as the invoker or be a descendant of the invoking process. 

RETURN VALUE 

setpgrp returns when the operation was successful. If the request failed, -1 is returned and the 
global variable errno indicates the reason. 

ERRORS 

setpgrp will fail and the process group will not be altered if one of the following occur: 

[ESRCH] The requested process does not exist. 

[EPERM] The effective user ID of the requested process is different from that of the 

caller and the process is not a descendent of the calling process. 

SEE ALSO 

getpgrp(2) 



c 



( 
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NAME 

setquota - enable/disable quotas on a file system 

SYNOPSIS 

setquota (special, file) 
char ^special, *file; 

DESCRIPTION 

Disc quotas are enabled or disabled with the setquota call, special indicates a block special 
device on which a mounted file system exists. If file is nonzero, it specifies a file in that file 
system from which to take the quotas. If file is 0, then quotas are disabled on the file system. 
The quota file must exist; it is normally created with the quotacheck(8) program. 

Only the super-user may turn quotas on or off . 

SPE ALSO 

quota(2), quotacheck(S), quotaon(8) 

RETURN VALUE 

A return value indicates a successful call. A value of -1 is returned when an error occurs 
and errno is set to indicate the reason for failure. 

ERRORS 

setquota will fail when one of the following occurs: 

[EPERM] The caller is not the super-user. 

[ENOENT] special does not exist. 

[ENOTBLK] special is not a block device. 

[ENXIO] The major device number of special is out of range (this indicates no 

device driver exists for the associated hardware). 

[EPERM] The pathname contains a character with the high-order bit set. 

[ENOTDIR] A component of the path prefix in file is not a directory. 

[EACCES] file resides on a file system different from special. 

[EACCES] file is not a plain file. 

[ENAMETOOLONG] The pathname was too long. 

[EFAULT] special or file points outside the process's allocated address space. 

[EIO] An I/O error occurred while reading from or writing to the file system. 

BUGS 

The error codes are in a state of disarray; too many errors appear to the caller as one value. 
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NAME 

setregid - set real and effective group ID 

SYNOPSIS 

setregid (rgid, egid) 
int rgid, egid; 

DESCRIPTION 

The real and effective group ID ? s of the current process are set to the arguments. Unprivileged 
users may change the real group ID to the effective group ID and vice-versa; only the super- 
user may make other changes. 

Supplying a value of -1 for either the real or effective group ID forces the system to substitute 
the current ID in place of the -1 parameter. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

ERRORS 

[EPERM] The current process is not the super-user and a change other than 

changing the effective group-id to the real group-id was specified. 

SEE ALSO 

getgid(2), setreuid(2), setgid(3) 



( 



( 



( 
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NAME 

setreuid - set real and effective user ID's 

SYNOPSIS 

setreuid (raid, euid) 
int raid, euid; 

DESCRIPTION 

The real and effective user ID's of the current process are set according to the arguments. If 
mid or euid is -1, the current uid is filled in by the system. Unprivileged users may change 
the real user ID to the effective user ID and vice-versa; only the super-user may make other 
changes, 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

ERRORS 

[EPERM] The current process is not the super-user and a change other than 

changing the effective user-id to the real user-id was specified. 

SEE ALSO 

getuid(2), setregid(2), setuid(3) 
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NAME 

shutdown .- stmt down part of a full-duplex connection 

SYNOPSIS 

shutdown (s, how) 
mt s, how; 

DESCRIPTION 

The shutdown call causes all or part of a full-duplex connection on the socket associated with 
$ to be shut down. If how is 0, then further receives will be disallowed. If how is 1, then 
further sends will be disallowed. If how is 2, then further sends and receives will be disal- 
lowed, 

DIAGNOSTICS 

A is returned if the call succeeds, -4 if it fails. 

ERRORS 

The call succeeds unless: 

[EBADF] s is not a valid descriptor. 

[ENOTSOCK] £ is a file, not a socket. 

[ENOTCONN] The specified socket is not connected. 

SEE ALSO 

connect(2), socket(2) 



c 



( 
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NAME 

sigblock - block signals 

SYNOPSIS 

#include <signahh> 

sigblock (mask); 
int mask; 

mask = sigmask(signum) 

DESCRIPTION 

sigblock causes the signals specified in mask to be added to the set of signals currently being 
blocked from delivery. Signals are blocked if the corresponding bit in mask is a 1; the macro 
sigmask is provided to construct the mask for a given signum. 

It is not possible to block SIGKILL, SIGSTOP, or SIGCONT; this restriction is silently imposed 
by the system. 

RETURN VALUE 

The previous set of masked signals is returned, 

SEE ALSO 

kill(2), sigvec(2), sigsetmask(2) 
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NAME 

sigpause - atomically release blocked signals and wait for interrupt 

SYNOPSIS 

sigpause (sigmask) 
int sigmask; 

DESCRIPTION 

sigpause assigns sigmask to the set of masked signals and then waits for a signal to arrive; on 
return the set of masked signals is restored, sigmask is usually to indicate that no signals are 
now to be blocked, sigpause always terminates by being interrupted, returning —1 with errno 
set to EINTR. 

In normal usage, a signal is blocked using sigblock(2), to begin a critical section, variables 
modified on the occurrence of the signal are examined to determine that there is no work to 
be done, and the process pauses awaiting work by using sigpause with the mask returned by 

sigblock. 

SEE ALSO 

sigblock(2), sigvec(2) 



( 



( 
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NAME 

sigreturn - return from signal 

SYNOPSIS 

#include <signal.h> 

sigreturn (scp); 
struct sigcontext *scp; 

DESCRIPTION 

sigreturn allows users to atomically unmask, switch stacks, and return from a signal context. 
The processes signal mask and stack status are restored from the context. The system call 
does not return; the users registers are restored from the context. Execution resumes at the 
specified program counter (sc^pc) in the signal context structure. This system call is used by 
the trampoline code, and longjmp(3) when returning from a signal to the previously executing 
program. 

NOTES 

This system call is not available in 4.2BSD, hence it should not be used if backward compati- 
bility is needed. 

RETURN VALUE 

If successful, the system call does not return. Otherwise, a value of -1 is returned and errno 
is set to indicate the error. 

ERRORS 

sigreturn will fail and the process context will remain unchanged if the following occurs. 

[EFAULT] scp points to memory that is not a valid part of the process address 

space. 

SEE ALSO 

sigvec(2), setjmp(3) 
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NAME 

sigsetmask, sigmask •- set current signal mask 

SYNOPSIS 

#include <s|gnal.h> 

sigsetmask (mask); 
int mask; 

mask = sigmask(sigrium) 

DESCRIPTION 

sigsetmask sets the current signal mask (those signals that are blocked from delivery). Signals 
are blocked if the corresponding bit in mask is a 1; the macro sigmask is provided to construct 
the mask for a given signum . 

The system quietly disallows SIGKILL, SIGSTOP, or SIGCONT to be blocked. 

RETURN VALUE 

The previous set of masked signals is returned. 

SEE ALSO 

kill(2), sigvec(2) s sigblock(2), sigpause(2) 



( 



c 
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NAME 

sigstack - set and/or get signal stack context 

SYNOPSIS 

#include <signaLh> 

struct sigstack { 

caddr_t ss„sp; 

int ss_onstack; 

.}; 

sigstack (ss, oss); 
struct sigstack *ss, *oss; 

DESCRIPTION 

sigstack allows users to define an alternate stack on which signals are to be processed. If ss is 
non-zsro, it specifies a signal stack on which to deliver signals and tells the system if the pro- 
cess is currently executing on that stack. When a signal's action indicates its handler should 
execute on the signal stack (specified with a sigvec(2) call), the system checks to see if the pro- 
cess is currently executing on that stack. If the process is not currently executing on the signal 
stack, the system arranges a switch to the signal stack for the duration of the signal handler's 
execution. If oss is non-zero, the current signal stack state is returned. 

NOTES 

Signal stacks are not "grown" automatically, as is done for the normal stack, If the stack 
overflows unpredictable results may occur. 

RETURN VALUE 

Upon successful completion, a value of is returned, Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

ERRORS 

sigstack will fail and the signal stack context will remain unchanged if one of the following 
occurs. 

[EFAULT] Either ss or oss points to memory that is not a valid part of the process 

address space, 

SEE ALSO 

sigvec(2), setjmp(3) 
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NAME 

sigvec - software signal facilities 

SYNOPSIS 

#include <signahh> 

struct sigvec { 

int (*sv_jiandier)0; 

int sv_mask; 

int svjftags; 

}; 

sigvec(sig ? vec, ovec) 

int sig; 

struct sigvec *vec 5 *ovec; 

DESCRIPTION 

The system defines a set of signals that may be delivered to a process , Signal delivery resem- 
bles the occurrence of a hardware interrupt: the signal is blocked from further occurrence, the 
current process context is saved, and a new one is built. A process may specify a handler to 
which a signal is delivered, or specify that a signal is to be blocked or ignored. A process may 
also specify that a default action is to be taken by the system when a signal occurs. Normally, 
signal handlers execute on the current stack of the process. This may be changed, on a per- 
handler basis, so that signals are taken on a special signal stack . 

All signals have the same priority. Signal routines execute with the signal that caused their 
invocation blocked, but other signals may yet occur. A global signal mask defines the set of 
signals currently blocked from delivery to a process. The signal mask for a process is initial- 
ized from that of its parent (normally 0). It may be changed with a sigblock(2) or sigset- 
rnask(2) call, or when a signal is delivered to the process. 

When a signal condition arises for a process, the signal is added to a set of signals pending for 
the process. If the signal is not currently blocked by the process then it is delivered to the 
process. When a signal is delivered, the current state of the process is saved, a new signal 
mask is calculated (as described below), and the signal handler is invoked. The call to the 
handler is arranged so that if the signal handling routine returns normally the process will 
resume execution in the context from before the signal's delivery. If the process wishes to 
resume in a different context, then it must arrange to restore the previous context itself. 

When a signal is delivered to a process a new signal mask is installed for the duration of the 
process' signal handler (or until a sigblock or sigsetmask call is made). This mask is formed by 
taking the current signal mask, adding the signal to be delivered, and or'ing in the signal mask 
associated with the handler to be invoked. 

sigvec assigns a handler for a specific signal. If vec is non-zero, it specifies a handler routine 
and mask to be used when delivering the specified signal. Further, if the SVJ3NSTACK bit is 
set in sv_flags, the system will deliver the signal to the process on a signal stack, specified with 
sigstack(2). If ovec is non-zero, the previous handling information for the signal is returned to 
the user. 



The following 


is a 


list of all signals with names as in the include file <signal.h>: 


SIGHUP 


1 


hangup 


SIGINT 


2 


interrupt 


SIGQUIT 


3* 


quit 


SIGILL 


4* 


illegal instruction 


SIGTRAP 


5* 


trace trap 


SIGIOT 


6* 


IOT instruction 


SIGEMT 


7* 


EMT instruction 



( 



( 
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SIGFPE 8* floating point exception 

SIGKILL 9 kill (cannot be caught, blocked, or 

SIGBUS 10* bus error 

SIGSEGV 11* segmentation violation 

SIGSYS 12* bad argument to system call 

SIGPIPE 13 write on a pipe with no 

SIGALRM 14 alarm clock 

SIGTERM 15 software termination signal 

SIGURG 16* urgent condition present on socket 

SIGSTOP 17f stop (cannot be caught, blocked, or 

SIGTSTP 18f stop signal generated from keyboard 

SIGCONT 19« continue after stop (cannot be blocked) 

SIGCHLD 20# child status has changed 

SIGTTIN 21f background read attempted from control terminal 

SIGTTOU 22f background write attempted to control terminal 

SIGIO 23* i/o is possible on a descriptor 

SIGXCPU 24 cpu time limit exceeded (see setrlimit(2)) 

SIGXFSZ 25 file size limit exceeded (see setrlimit(2)) 

SIGVTALRM 26 virtual time alarm (see setitimer(2)) 

SIGPROF 27 profiling timer alarm (see setitimer(2)) 

SIGWINCH 28# window size change 

SIGUSR1 30 user defined signal 1 

SIGUSR2 31 user defined signal 2 

The starred signals in the list above cause a core image if not caught or ignored. 

Once a signal handler is installed, it remains installed until another sigvec call is made, or an 
execve(2) is performed. The default action for a signal may be reinstated by setting svjiandler 
to SIGJDFL; this default is termination (with a core image for starred signals) except for sig- 
nals marked with • or f- Signals marked with • are discarded if the action is SIG_DFL; sig- 
nals marked with f cause the process to stop. If svjiandler is SIGJGN the signal is subse- 
quently ignored, and pending instances of the signal are discarded. 

If a caught signal occurs during certain system calls, the call is normally restarted. The call 
can be forced to terminate prematurely with an EINTR error return by setting the 
SVJNTERRUPT bit in svjlags. The affected system calls are read (2) or write (2) on a slow dev- 
ice (such as a terminal; but not a file) and during a wait (2). 

After & fork (2) or vfork(2) the child inherits all signals, the signal mask, the signal stack, and 
the restart/interrupt flags. 

execve(2) resets all caught signals to default action and resets all signals to be caught on the 
user stack. Ignored signals remain ignored; the signal mask remains the same; signals that 
interrupt system calls continue to do so. 

The mask specified in vec is not allowed to block SIGKILL, SIGSTOP, or SIGCONT. This is 
done silently by the system. 

The SVJNTERRUPT flag is not available in 4.2BSD, hence it should not be used if backward 
compatibility is needed. 

RETURN VALUE 

A value indicated that the call succeeded. A -1 return value indicates an error occurred 
and errno set to indicated the reason. 
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ERRORS 

sigvec will fail and no new signal handler will be installed if one of the following occurs: 

[EFAULT] Either vec or ovec points to memory that is not a valid part of the pro- 

cess address space, 

[EINVAL] sig is not a valid signal number. 

[EINVAL] An attempt is made to ignore or supply a handler for SIGKILL or SIG- 

STOP. 



( 



[EINVAL] 



An attempt is made to ignore SIGCONT (by default SIGCONT is 
ignored). 



SEE ALSO 



kill(l), ptrace(2), kill(2), sigblock(2), sigsetmask(2), sigpause(2), sigstack(2), sigvec(2), 
setjmp(3), siginterrupt(3) ? tty(4), sigreturn(2), emulate__branch(3), fpc(3), cachejlusb(2) 
R2010 Floating Point Coprocessor Architecture Engineering Description 
R2360 Floating Point Board Product Description 

NOTES (MIPS) 

The handler routine can be declared: 

handler( sig, code, scp) 

int sig, code; 

struct sigcontext *scp; 

Here sig is the signal number. MIPS hardware exceptions are mapped to specific signals as 
defined by the table below, code is a parameter that is either a constant as given below or 
zero, scp is a pointer to the sigcontext structure (defined in <signal.h>), that is the context at 
the time of the signal and is used to restore the context if the signal handler returns. 

The following defines the mapping of MIPS hardware exceptions to signals and codes. All of 
these symbols are defined in either <signahh> or <mips/cpu.h>: 

Hardware exception Signal Code 

Integer overflow 

Segmentation violation 

Illegal Instruction 

Coprocessor Unusable 

Data Bus Error 

In struction Bus Error 

Read Address Error 

Write Address Error 

User Breakpoint (used by debuggers) 

Kernel Breakpoint (used by prom) 

Taken Branch Delay Emulation 

Not Taken Branch Delay Emulation 

User Single Step (used by debuggers) 

Overflow Check 

Divide by Zero Check 

Range Error Check 

When a signal handler is reached, the program counter in the signal context structure (sc_j)c) 
points at the instruction that caused the exception as modified by the branch delay bit in the 
cause register. The cause register at the time of the exception is also saved in the sigcontext 
structure {scjoause). If the instruction that caused the exception is at a valid user address it 
can be retrieved with the following code sequence: 



( 



SIGFPE 


EXC_OV 


SIGSEGV 


SEXCLSEGV 


SIGILL 


EXCJI 


SIGILL 


SEXCLCPU 


SIGBUS 


EXCJDBE 


SIGBUS 


EXCISE 


SIGBUS 


EXCJRADE 


SIGBUS 


EXC.WADE 


SIGTRAP 


BRKJUSERBP 


SIGTRAP 


BRKJCERNELBP 


SIGTRAP 


BRKJ8DJTAKEN 


SIGTRAP 


BRK^BDJTOTTAKEN 


SIGTRAP 


BRK_SSTEPBP 


SIGTRAP 


BRKLOVERFLOW 


SIGTRAP 


BRKJ3IVZERO 


SIGTRAP 


BRELRANGE 



( 
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if(scp->sc_cause & CAUSEJ3D){ 

branchjmstruction = ^(unsigned long *)(scp->sc_pc); 
exception .instruction - ^(unsigned long *)(scp~>sc_pc + 4); 

} 

else 

exceptionjnstruction = *(unsigned long *)(scp->sc_pc); 

Where CAUSEJ3D is defined in <mips/cpu.h>. 

The signal handler may fix the cause of the exception and re-execute the instruction, emulate 
the instruction and then step over it or perform some non-local goto such as a longjumpQ or 
an exitQ. 

If corrective action is performed in the signal handler and the instruction that caused the 
exception would then execute without a further exception, the signal handler simply returns 
and re-executes the instruction (even when the branch delay bit is set). 

If execution is to continue after stepping over the instruction that caused the exception the 
program counter must be advanced. If the branch delay bit is set the program counter is set 
to the target of the branch else it is incremented by 4. This can be done with the following 
code sequence: 

if(scp->sc_cause & CAUSE^BD) 

emulate_branch(scp, branchjnstruction); 
else 

scp->sc_pc +=4; 

emulate Jbranch() modifies the program counter value in the sigcontext structure to the target 
of the branch instruction. See emulate Jbranch (3) for more details. 

For SIGFPE's generated by floating-point instructions (code == 0) the floating-point control and 
status register at the time of the exception is also saved in the sigcontext structure (scjpc_csr). 
This register has the information on which exceptions have occurred. When a signal handler 
is entered the register contains the value at the time of the exception but with the exceptions 
bits cleared. On a return from the signal handler the exception bits in the floating-point con- 
trol and status register are also cleared so that another SIGFPE will not occur (all other bits are 
restored from scjpcjcsr). 

K the floating-point unit is a R2360 (a floating-point board) and a SIGFPE is generated by the 
floating-point unit (code == 0) and program counter does not point at the instruction that 
caused the exception. In this case the instruction that caused the exception is in the floating- 
point instruction exception register. The floating-point instruction exception register at the time 
of the exception is also saved in the sigcontext structure (sc_fpc_eir). In this case the instruc- 
tion that caused the exception can be retrieved with the following code sequence: 

union fpc_irr fpajrr; 

fpc_irr.fi_word = get_fpc_irr(); 
if(sig = SIGFPE && code == && 
fpcjn\fi_struct. implementation == IMPLEMENT A TION_R2360) 
exception Jnstruction = scp->sc_fpc_eir; 

The union fpcjrr, and the constant IMPLEMENTATION_R2360 are defined in <mips/fpu.h>. 
For the description of the routine get_fpcjrr() see fpc(3). All other floating-point implemen- 
tations are handled in the normal manner with the instruction that caused the exception at the 
program counter as modified by the branch delay bit. 
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For SIGSEGV and SIGBUS errors the faulting virtual address is saved in scjbadvaddr in the sig- i 

nal context structure. ^ 

The SIGTRAP's caused by break instructions noted in the above table and all other yet to be 
defined break instructions fill the code parameter with the first argument to the break instruc- 
tion (bits 25-16 of the instruction). 



( 



( 
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NAME 

socket - create an endpoint for communication 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/socket.h> 

s = socket(domain, type, protocol) 
int s, domain, type, protocol; 

DESCRIPTION 

socket creates an endpoint for communication and returns a descriptor. 

The domain parameter specifies a communications domain within which communication will 
take place; this selects the protocol family which should be used. The protocol family gen- 
erally is the same as the address family for the addresses supplied in later operations on the 
socket. These families are defined in the include file <sy s/ socket. h> . The currently under- 
stood formats are 

PF_UNIX (UNIX internal protocols), 

PFJNET (ARPA Internet protocols), 

PF_NS (Xerox Network Systems protocols), and 

PFJMPLINK (IMP "host at IMP" link layer). 

The socket has the indicated type, which specifies the semantics of communication. Currently 
defined types are: 

SOCK_STREAM 

SOCKJDGRAM 

SOCKJRAW 

SOCK_SEQPACKET 

SOCKJRDM 

A SOCKJSTREAM type provides sequenced, reliable, two-way connection based byte streams. 
An out-of-band data transmission mechanism may be supported. A SOCKJDGRAM socket 
supports datagrams (connectionless, unreliable messages of a fixed (typically small) maximum 
length). A SOCK_SEQPACKET socket may provide a sequenced, reliable, two-way 
connection-based data transmission path for datagrams of fixed maximum length; a consumer 
may be required to read an entire packet with each read system call. This facility is protocol 
specific, and presently implemented only for PFJNS. SOCKJIAW sockets provide access to 
internal network protocols and interfaces. The types SOCKJIAW, which is available only to 
the super-user, and SOCKJRDM, which is planned, but not yet implemented, are not described 
here. 

The protocol specifies a particular protocol to be used with the socket. Normally only a single 
protocol exists to support a particular socket type within a given protocol family. However, it 
is possible that many protocols may exist, in which case a particular protocol must be 
specified in this manner. The protocol number to use is particular to the "communication 
domain" in which communication is to take place; see protocols (3N). 

Sockets of type SOCK_STREAM are full-duplex byte streams, similar to pipes. A stream 
socket must be in a connected state before any data may be sent or received on it. A connec- 
tion to another socket is created with & connect (2) call. Once connected, data may be 
transferred using read (2) and write (2) calls or some variant of the send (2) and recv{2) calls. 
When a session has been completed a close (2) may be performed. Out-of-band data may also 
be transmitted as described in send (2) and received as described in recv(2). 
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The communications protocols used to implement a SOCK„STREAM insure that data is not | 

lost or duplicated. If a piece of data for which the peer protocol has buffer space cannot be ^ 

successfully transmitted within a reasonable length of time, then the connection is considered 
broken and calls will indicate an error with -1 returns and with ETIMEDOUT as the specific 
code in the global variable errno. The protocols optionally keep sockets "warm" by forcing 
transmissions roughly every minute in the absence of other activity. An error is then indicated 
if no response can be elicited on an otherwise idle connection for a extended period (e.g. 5 
minutes). A SIGPIPE signal is raised if a on a broken stream; this causes naive processes, which 
do not handle the signal, to exit. 

SOCKJSEQPACKET sockets employ the same system calls as SOCK_STREAM sockets. The 
only difference is that read(2) calls will return only the amount of data requested, and any 
remaining in the arriving packet will be discarded. 

SOCKJDGRAM and SOCKJLAW sockets allow sending of datagrams to correspondents named 
in send (2) calls. Datagrams are generally received with recvfrom (2), which returns the next 
datagram with its return address. 

An fcntl(2) call can be used to specify a process group to receive a SIGURG signal when the 
out-of-band data arrives. It may also enable non-blocking I/O and asynchronous notification 
of I/O events via SIGIO. 

The operation of sockets is controlled by socket level options. These options are defined in 
the file <sys/ socket. h>. setsockopt(2) and getsockopt{2) are used to set and get options, 
respectively. 

RETURN VALUE 

A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the 
socket. 



ERRORS 

The socket call fails if; 

[EPROTONO SUPPORT] 

The protocol type or the specified protocol is not supported within this 
domain. 

[EMFILE] The per-process descriptor table is full. 

[ENFILE] The system file table is full. 

[EACCESS] Permission to create a socket of the specified type and/or protocol is 

denied, 

[ENOBUFS] Insufficient buffer space is available. The socket cannot be created until 

sufficient resources are freed. 

SEE ALSO 

accept(2), bind(2), connect(2), getsockname(2), getsockopt(2), ioctl(2), list en (2), read(2), 
recv(2), select(2), send(2), shutdown(2)> socketpair(2), write(2) 

"An Introductory 4.3BSD Interprocess Communication Tutorial." (reprinted in UNIX 
Programmers Supplementary Documents Volume 1, PS1:7) "An Advanced 4.3BSD Interpro- 
cess Communication Tutorial." (reprinted in UNIX Programmer's Supplementary Documents 
Volume 1, PS1:8) 
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NAME 

socketpair - create a pair of connected sockets 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/socket.h> 

socketpair (d, type, protocol, sv) 
int d, type, protocol; 

int sv[2]; 

DESCRIPTION 

The socketpair call creates an unnamed pair of connected sockets in the specified domain d, 
of the specified type, and using the optionally specified protocol. The descriptors used in 
referencing the new sockets are returned in sv[0] and .sv[l]. The two sockets are indistinguish- 
able. 

DIAGNOSTICS 

A is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

[EMFILE] Too many descriptors are in use by this process. 

[EAFNOSUPPORT] The specified address family is not supported on this machine. 

[EPROTONO SUPPORT] The specified protocol is not supported on this machine. 

[EOPNOTSUPP] The specified protocol does not support creation of socket pairs. 

[EFAULT] The address $v does not specify a valid part of the process address 

space. 

SEE ALSO 

read (2), write(2), pipe(2) 

BUGS 

This call is currently implemented only for the UNIX domain. 
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NAME 

stat, Istat, fstat - get file status 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/stat.h> 

stat (path, but) 
char *path; 
struct stat *biif; 

l$tat(path, buf) 
char *path; 
struct stat *buf; 

fstat(fd, buf) 

int fd; 

struct stat *buf; 

DESCRIPTION 

stat obtains information about the file path. Read, write or execute permission of the named 
file is not required, but all directories listed in the path name leading to the file must be reach- 
able. 

Istat is like stat except in the case where the named file is a symbolic link, in which cape Istat 
returns information about the link, while stat returns information about the file the link refer- 
ences. 

fstat obtains the same information about an open file referenced by the argument descriptor, 
such as would be obtained by an open call. 

huf is a pointer to a stat structure into which information is placed concerning the file. The 
contents of the structure pointed to by buf 

struct stat { 

/* device inode resides on */ 

/* this inode's number */ 

/* protection */ 

/* number or hard links to the file */ 

/* user-id of owner */ 

/* group-id of owner */ 

/* the device type, for inode that is device */ 

/* total size of file */ 

/* file last access time */ 

/* file last modify time */ 

/* file last status change time */ 

/* optimal blocksize for file system i/o ops */ 
/* actual number of blocks allocated */ 



was last read or modified. Changed by the follow- 
ing system calls: mknod{2), utimes(2), read(2), and write (2). For rea- 
sons of efficiency, st_atime is not set when a directory is searched, 
although this would be more logical. 



( 





devj: 


st_dev; 




ino_t 


stino; 




u^short 


st_mode; 




short 


st_nlink; 




short 


st_uid; 




short 


st_gid; 




devj 


stjrdev; 




ofltt 


stjsize; 




time J 


st_atime; 




int 


sLjsparel; 




time_t 


st_mtime; 




int 


st_spare2; 




timej 


st_ctime; 




int 


st_spare3; 




long 


st_blksize; 




long 


st-blocks; 




long 


st_spare4[2]; 


}; 






st„atime 


Time when file d 
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st_mtime Time when data was last modified. It is not set by changes of owner, 

group, link count, or mode. Changed by the following system calls; 
mknod{2), utimes(2), write (2). 

st_ctime Time when file status was last changed. It is set both both by writing 

and changing the i-node. Changed by the following system calls: 
chmod{2) chown{2), link (2), mknod(2), rename (2), unlink (2), utimes(2), 
write (2). 

The status information word st_mode has bits: 



#define SJDFMT 


0170000 


/* type of file */ 


#define SJQFDIR 


0040000 


/* directory */ 


#define SJFCHR 


0020000 


/* character special */ 


#define S_IFBLK 


0060000 


/* block special */ 


#define SJGHREG 


0100000 


/* regular */ 


#define SJFLNK 


0200000 


/* symbolic link */ 


#define S_IFSOCK 


0140000 


/* socket */ 


#define SJSUID 


0004000 


/* set user id on execution */ 


#define S_ISGID 


0002000 


/* set group id on execution */ 


#define S_ISVTX 


0001000 


/* save swapped text even after use */ 


#define S_IREAD 


0000400 


/* read permission, owner */ 


#define S_JWRITE 


0000200 


/* write permission, owner */ 


#define S_IEXEC 


0000100 


/* execute/search permission, owner */ 



The mode bits 0000070 and 0000007 encode group and others permissions (see chmod{2)). 

RETURN VALUE 

Upon successful completion a value of is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

stat and 1st at will fail if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EFAULT] buf or name points to an invalid address. 

[EIO] An I/O error occurred while reading from or writing to the file system. 

fstat will fail if one or both of the following are true: 

[EBADF] fildes is not a valid open file descriptor. 

[EFAULT] buf points to an invalid address. 

[EIO] An I/O error occurred while reading from or writing to the file system. 



CAVEAT 



The fields in the stat structure currently marked stjsparel, st_jipare2, and stjspare3 are present 
in preparation for inode time stamps expanding to 64 bits. This, however, can break certain 
programs that depend on the time stamps being contiguous (in calls to utimes(2))< 
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SEE ALSO i^ 

chmod(2), chown(2), utimes(2) V 

BUGS 

Applying fstat to a socket (and thus to a pipe) returns a zero'd buffer, except for the blocksize 
field, and a unique device and mode number. 
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NAME 

statfs - get file system statistics 

SYNOPSIS 

#include <sys/vfs,h> 

statfs (path, buf) 
char *path; 
struct statfs *buf; 

fstatfs(fd, buf) 

int fd; 

struct statfs *buf; 

DESCRIPTION 

statfs returns information about a mounted file system, path is the path name of any file 
within the mounted filesystem. buf is a pointer to a statfs structure defined as follows: 



typedef struct 


{ 


long 


val[2]; 


} fsid_t; 




struct statfs { 




long 


f-type; 


long 


f_bsize; 


long 


f_blocks; 


long 


f_bfree; 


long 


f_bavail; 


long 


f_files; 


long 


fJHree; 


fsid_t 


f_fsid; 



/* type of info, zero for now */ 

/* fundamental file system block size */ 

/* total blocks in file system */ 

/* free blocks */ 

/* free blocks available to non-superuser */ 

/* total file nodes in file system */ 

/* free file nodes in fs */ 

/* file system id */ 



}; 



long f_spare[7]; /* spare for later */ 



Fields that are undefined for a particular file system are set to -1. fstatfs returns the same 
information about an open file referenced by descriptor fd . 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, -1 is returned and the glo- 
bal variable errno is set to indicate the error. 

ERRORS 

statfs fails if one or more of the following are true: 

A component of the path prefix of path is not a directory. 

path contains a character with the high-order bit set. 

The length of a component of path exceeds 255 characters, or the length 
of path exceeds 1023 characters. 

The file referred to by path does not exist. 

Search permission is denied for a component of the path prefix of path . 

Too many symbolic links were encountered in translating path . 

buf or path points to an invalid address. 

An I/O error occurred while reading from or writing to the file system. 



ENOTDIR 

EINVAL 

ENAMETOOLONG 

ENOENT 

EACCES 

ELOOP 

EFAULT 

EIO 
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fstatfs fails if one or both of the following are true; 

EBADF fd is not a valid open file descriptor. 

EFAULT buf points to an invalid address. 

EIO An I/O error occurred while reading from or writing to the file system. 
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NAME 

swapon - add a swap device for interleaved paging/ swapping 

SYNOPSIS 

swapon (special) 
char ^special; 

DESCRIPTION 

swapon makes the block device special available to the system for allocation for paging and 
swapping. The names of potentially available devices are known to the system and defined at 
system configuration time. The size of the swap area on special is calculated at the time the 
device is first made available for swapping. 

RETURN VALUE 

If an error has occurred, a value of -1 is returned and errno is set to indicate the error. 

ERRORS 

swapon succeeds unless: 

[ENOTDIR] A component of the path prefix is not a directory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters. 

[ENOENT] The named device does not exist, 

[EACCES] Search permission is denied for a component of the path prefix. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EPERM] The caller is not the super-user. 

[ENOTBLK] special is not a block device. 

[EBUSY] The device specified by special has already been made available for 

swapping 

[EINVAL] The device configured by special was not configured into the system as a 

swap device. 

[ENXIO] The major device number of special is out of range (this indicates no 

device driver exists for the associated hardware). 

[EIO] An I/O error occurred while opening the swap device. 

[EFAULT] special points outside the process's allocated address space. 

SEE ALSO 

swapon(8), config(8) 

BUGS 

There is no way to stop swapping on a disk so that the pack may be dismounted. 

This call will be upgraded in future versions of the system. 
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NAME 

symlink - make symbolic link to a file 

SYNOPSIS 

symlink (namel, name2) 
char *raamel, *name2; 

DESCRIPTION 

A symbolic link name2 is created to namel (name2 is the name of the file created, namel is 
the string used in creating the symbolic link). Either name may be an arbitrary path name; the 
files need not be on the same file system. 

RETURN VALUE 

Upon successful completion, a zero value is returned. If an error occurs, the error code is 
stored in errno and a -1 value is returned. 

ERRORS 

The symbolic link is made unless on or more of the following are true: 

[ENOTDIR] A component of the name2 prefix is not a directory. 

[EINVAL] Either namel or name2 contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of either pathname exceeded 255 characters, or the entire 
length of either path name exceeded 1023 characters. 

[ENOENT] The named file does not exist, 

[EACCES] A component of the name2 path prefix denies search permission, 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EEXIST] name2 already exists. 

[EIO] An I/O error occurred while making the directory entry for name2, or 

allocating the inode for name2 9 or writing out the link contents of 
name2. 

The file name2 would reside on a read-only file system. 

The directory in which the entry for the new symbolic link is being 



c 



[EROFS] 
[ENOSPC] 

[ENOSPC] 
[ENOSPC] 
[EDQUOT] 

[EDQUOT] 

[EDQUOT] 

[EIO] 

[EFAULT] 



placed cannot be extended because there is no space left on the file sys- 
tem containing the directory. 

The new symbolic link cannot be created because there there is no 
space left on the file system that will contain the symbolic link. 

There are no free modes on the file system on which the symbolic link is 
being created. 

The directory in which the entry for the new symbolic link is being 
placed cannot be extended because the user's quota of disk blocks on 
the file system containing the directory has been exhausted. 

The new symbolic link cannot be created because the user's quota of 
disk blocks on the file system that will contain the symbolic link has 
been exhausted. 

The user's quota of inodes on the file system on which the symbolic link 
is being created has been exhausted. 

An I/O error occurred while making the directory entry or allocating the 
inode. 

namel or name2 points outside the process's allocated address space. 



( 



( 



MIPS Computer Systems, Inc. 



February 5, X989 



Page 1 



SYMLINK ( 2-BSD ) RISC/os Programmer's Reference SYMLINK ( 2-BSD ) 



SEE AI.SO 

link(2), ln(l), unlink(2) 



Page 2 February 5, 1989 MIPS Computer Systems, Inc. 



SYNC ( 2-BSD ) RISC/os Programmer's Reference SYNC ( 2-BSD ) 



NAME 

sync - update super-block 

SYNOPSIS 

syncO 

DESCRIPTION 

sync causes all information in core memory that should be on disk to be written out. This 
includes modified super blocks, modified i-nodes y and delayed block I/O, 

sync should be used by programs that examine a file system, for example fsck, df, etc. sync is 
mandatory before a boot. 

SEE ALSO 

fsync(2), sync(8), update(8) 

BUGS 

The writing, although scheduled, is not necessarily complete upon return from sync. 
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NAME 

syscall - indirect system call 

SYNOPSIS 

#in chide <syscall.h> 

syscall (number, arg, ...) (VAX-11) 

DESCRIPTION 

syscall performs the system call whose assembly language interface has the specified number, 
register arguments rO and rl and further arguments arg. Symbolic constants for system calls 
can be found in the header file <syscall.h>. 

The rO value of the system call is returned. 

DIAGNOSTICS 

When the Obit is set, syscall returns -1 and sets the external variable errno (see intro(2)). 

BUGS 

There is no way to simulate system calls such as pipe (2), which return values in register rl. 
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NAME 

truncate, f truncate - truncate a file to a specified length 

SYNOPSIS 

truncate (path 9 length) 
char *path; 
oflLt length; 

ftruncate(fd, length) 

intfd; 

off_J; length; 

DESCRIPTION 

truncate causes the file named by path or referenced by fd to be truncated to at most length 
bytes in size. If the file previously was larger than this size, the extra data is lost, With /trun- 
cate, the file must be open for writing, 

RETURN VALUES 

A value of is returned if the call succeeds. If the callfails a -1 is returned, and the global 
variable errno specifies the error. 

ERRORS 

truncate succeeds unless: r.TP 20 [ENOTDIR] A component of the path prefix is not a direc- 
tory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOQLONG] A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters, 

[ENOENT] The named file does not exist £ 

[EACCES] Search permission is denied for a component of the path prefix. ^- 

[EACCES] The named file is not writable by the user. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EISDIR] The named file is a directory. 

[ERQFS] The named file resides on a read-only file system. 

[ETXTBSY] The file is a pure procedure (shared text) file that is being executed. 

[EIO] An I/O error occurred updating the inode. 

[EFAULTJ Path points outside the process's allocated address space. 

/truncate succeeds unless: 

[EBADF] The fd is not a valid descriptor. 

[EINVAL] The. fd references a socket, not a file. 

[EINVAL] The fd is not open for writing. 

SEE ALSO 

open(2) 

BUGS 

These calls should be generalized to allow ranges of bytes in a file to be discarded. 



( 
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NAME 

umask - set file creation mode mask 

SYNOPSIS 

oumask s umask(numask) 
int oumask, numask; 

DESCRIPTION 

umask sets the process's file mode creation mask to numask and returns the previous value of 
the mask. The low-order 9 bits of numask are used whenever a file is created, clearing 
corresponding bits in the file mode (see chmod(2)). This clearing allows each user to restrict 
the default access to his files. 

The value is initially 022 (write access for owner only). The mask is inherited by child 
processes. 

RETURN VALUE 

The previous value of the file mode mask is returned by the call. 

SEE ALSO 

chmod(2), mknod(2), open(2) 
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NAME I 

uname - get general system information 

SYNOPSIS 

#include <sys/utsname.h> 

int uname (en) 
struct utsname *un; 

DESCRIPTION 

uname stores information identifying the current operating system and machine into the struc- 
ture pointed to by the argument. 

The utsname structure is defined in the include file <sys/utsname.h>. It consists of 13 fields, 
7 of which are defined and the rest of which are reserved for future use. The currently 
defined fields (with available values) are: 

sysname The network identification name (same as the hostname). 

nodename The network identification name (same as the hostname and the above 

sysname field). 

release The operating system release name. 

version The MIPS system version number. 

machine The hardware type. 

m_type (MPS-specific) The MIPS hardware type. 

foase_rel (MlPS-specific) The base release for the system. 

The valid values for these fields are defined in the utsname. h include file. i 

RETURN VALUE * 

If successful, uname will return a non-negative value; otherwise, it will return -1 and errno will 
indicate the error. 

SEE ALSO 

hwconf(2), gethostname(2). 
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NAME 

unlink - remove directory entry 

SYNOPSIS 

unlink (path) 
char *path; 

DESCRIPTION 

unlink removes the entry for the file path from its directory. If this entry was the last link to 
the file, and no process has the file open, then all resources associated with the file are 
reclaimed. If, however, the file was open in any process, the actual resource reclamation is 
delayed until it is closed, even though the directory entry has disappeared. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

ERRORS 

The unlink succeeds unless: 

[ENOTDIR] A component of the path prefix is not a directory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[EACCES] Write permission is denied on the directory containing the link to be 

removed. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EPERM] The named file is a directory and the effective user ID of the process is 

not the super-user. 

[EPERM] The directory containing the file is marked sticky, and neither the con- 

taining directory nor the file to be removed are owned by the effective 
user ID. 

[EBUSY] The entry to be unlinked is the mount point for a mounted file system. 

[EIO] An I/O error occurred while deleting the directory entry or deallocating 

the inode. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] path points outside the process's allocated address space. 

SEE ALSO 

close(2), link(2), rmdir(2) 
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NAME f 

unmount - remove a file system ^ 

SYNOPSIS 

unmount (name) 
char *name; 

DESCRIPTION 

unmount announces to the system that the directory name is no longer to refer to the root of a 
mounted file system. The directory name reverts to its ordinary interpretation. 

RETURN VALUE 

unmount returns if the action occurred; -1 if if the directory is inaccessible or does not have 
a mounted file system, or if there are active files in the mounted file system. 

ERRORS 

unmount may fail with one of the following errors: 

EPERM The caller is not the super-user. 

ENOTDIR A component of the path prefix of name is not a directory. 

EINVAL name is not the root of a mounted file system. 

EBUSY A process is holding a reference to a file located on the file system. 

EINVAL The path name contains a character with the high-order bit set. 

ENAMETOOLONG The length of a component of the path name exceeds 255 characters, or 
the length of the entire path name exceeds 1023 characters. 

ENOENT name does not exist. 

EACCES Search permission is denied for a component of the path prefix. I 

EFAULT name points outside the process's allocated address space. 

ELOOP Too many symbolic links were encountered in translating the path name, 

EIO An I/O error occurred while reading from or writing to the file system. 

SEE ALSO 

mount(2), mount(S), umount(8) 

BUGS 

The error codes are in a state of disarray; too many errors appear to the caller as one value. 
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NAME 



utimes - set file times 



SYNOPSIS 

#in elude <sys/time.h> 

utimes (file, tvp) 

char *file; 

struct timeval tvp [2]; 

DESCRIPTION 

The utimes call uses the "accessed" and "updated" times in that order from the tvp vector to 
set the corresponding recorded times for file. 

The caller must be the owner of the file or the super-user. The "inode-changed" time of the 
file is set to the current time. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

ERRORS 

utime will fail if one or more of the following are true: 

[ENOTDIR] - A component of the path prefix is not a directory. 

[EINVAL] The pathname contains a character with the high-order bit set. 

[ENAMETQOLONG] A component of a pathname exceeded 255 characters, or an entire path 
name exceeded 1023 characters. 

The named file does not exist. 

Too many symbolic links were encountered in translating the pathname. 

The process is not super-user and not the owner of the file. 

Search permission is denied for a component of the path prefix. 

The file system containing the file is mounted read-only. 

file or tvp points outside the process's allocated address space. 

An I/O error occurred while reading or writing the affected inode. 



[ENOENT] 

[E]LOOP] 

[EPERM] 

[EACCES] 

[EROFS] 

[EFAULT] 

[EIO] 

SEE ALSO 

stat(2) 
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NAME 

vfork - spawn new process in a virtual memory efficient way 

SYNOPSIS 

pid = vfork 
Int pid; 

DESCRIPTION 

vfork can be used to create new processes without fully copying the address space of the old 
process, which is horrendously inefficient in a paged environment. It is useful when the pur- 
pose of fork (2) would have been to create a new system context for an execve- vfork differs 
from fork in that the child borrows the parent's memory and thread of control until a call to 
execve(2) or an exit (either by a call to exit (2) or abnormally.) The parent process is suspended 
while the child is using its resources. 

vfork returns in the child's context and (later) the pid of the child in the parent's context. 

vfork can normally be used just like fork. It does not work, however, to return while running 
in the childs context from the procedure that called vfork since the eventual return from vfork 
would then return to a no longer existent stack frame. Be careful, also, to call _exit rather 
than exit if you can't execve, since exit will flush and close standard I/O channels, and thereby 
mess up the parent processes standard I/O data structures. (Even with fork it is wrong to call 
exit since buffered data would then be flushed twice.) 

SEE ALSO 

fork(2), execve(2), sigvec(2), wait (2), 

DIAGNOSTICS 

Same as for fork. 

BUGS 

This system call will be eliminated when proper system sharing mechanisms are implemented. 
Users should not depend on the memory sharing semantics of vfork as it will, in that case, be 
made synonymous to fork . 

To avoid a possible deadlock situation, processes that are children in the middle of a vfork 
are never sent SIGTTOU or SJGTTIN signals; rather, output or iocth are allowed and input 
attempts result in an end-of-file indication. 
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NAME 

vhangup - virtually "hangup" the current control terminal 

SYNOPSIS 

vhangup 

DESCRIPTION 

vhangup is used by the initialization process init(8) (among others) to arrange that users are 
given "clean"' terminals at login, by revoking access of the previous users' processes to the 
terminal. To effect this, vhangup searches the system tables for references to the control ter- 
minal of the invoking process, revoking access permissions on each instance of the terminal 
that it finds. Further attempts to access the terminal by the affected processes will yield i/o 
errors (EBADF). Finally, a hangup signal (SIGHUP) is sent to the process group of the control 
terminal. 

SEE ALSO 

init (8) 

BUGS 

Access to the control terminal via /dev/tty is still possible. 

This call should be replaced by an automatic mechanism that takes place on process exit. 
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NAME 

wait, wait3 - wait for process to terminate 

SYNOPSIS 

#include <sys/wait.h> 

pid s wait (status) 

int pid; 

union wait *status; 

pid s= wait(O) 
int pid; 

#include < sy s/time.h > 
#mdude <sys/re source Jh> 

pid = wait3 (status, options, rusage) 

int pid; 

union wait ^status; 

int options; 

struct rusage *rusage; 

pid = mips_„wait3 (status, options, rusage, rusage_size) 

int pid; 

union wait ^status; 

int options; 

struct rusage *rusage; 

int rusage_size; 

DESCRIPTION 

wait causes its caller to delay until a signal is received or one of its child processes terminates. 
If any child has died since the last wait, return is immediate, returning the process id and exit 
status of one of the terminated children. If there are no children, return is immediate with 
the value -1 returned. 

On return from a successful wait call, status is nonzero, and the high byte of status contains 
the low byte of the argument to exit supplied by the child process; the low byte of status con- 
tains the termination status of the process. A more precise definition of the status word is 
given in <sys/wait.h>« 

wait3 provides an alternate interface for programs that must not block when collecting the 
status of child processes, MipsjwaitS performs the same function as waitS but takes a fourth 
argument which is the size of the rusage structure. This interface will be used in the future to 
return MIPS hardware specific resource use information as the rusage structure is extended. 

The status parameter is defined as above. The options parameter is used to indicate the call 
should not block if there are no processes that wish to report status (WNOHANG), and/or that 
children of the current process that are stopped due to a SIGTTIN, SIGTTOU, SIGTSTP, or 
SIGSTOP signal should also have their status reported (WUNTRACED). If rusage is non-zero, a 
summary of the resources used by the terminated process and all its children is returned (this 
information is currently not available for stopped processes). 

When the WNOHANG option is specified and no processes wish to report status, waitS returns 
a pid of 0. The WNOHANG and WUNTRACED options may be combined by or'ing the two 
values. 

NOTES 

See $igvec(2) for a list of termination statuses (signals); status indicates normal termination. 
A special status (0177) is returned for a stopped process that has not terminated and can be 
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restarted; see ptrace{2). If the 0200 bit of the termination status is set, a core image of the 
process was produced by the system. 

If the parent process terminates without waiting on its children, the initialization process (pro- 
cess ID = 1) inherits the children. 

wait and wait3 are automatically restarted when a process receives a signal while awaiting ter- 
mination of a child process. 

RETURN VALUE 

If wait returns due to a stopped or terminated child process, the process ID of the child is 
returned to the calling process. Otherwise, a value of -1 is returned and errno is set to indi- 
cate the error. 

wait3 returns -1 if there are no children not previously waited for; is returned if WNOHANG 
is specified and there are no stopped or exited children. 

ERRORS 

wait will fail and return immediately if one or more of the following are true: 

[ECHILD] The calling process has no existing unwaited-for child processes. 

[EFAULT] The status or rusage arguments point to an illegal address. 

SEE ALSO 

exit(2) 
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NAME f 

write, writev - write output ^ 

SYNOPSIS 

cc = write (d, buf, nbytes) 
int cc, d; 
char *buf; 
int nbytes; 

#mclude <sys/types.h> 
#inciude <sys/uio.h> 

cc = writev(d, iov, iovcnt) 

int cc, d; 

struct iovec *iov; 

int Iovcnt; 

DESCRIPTION 

write attempts to write nbytes of data to the object referenced by the descriptor d from the 
buffer pointed to by buf. writev performs the same action, but gathers the output data from 
the iovcnt buffers specified by the members of the iov array: iov[0], iov[l], ..., iov[iovcnt - 1]. 

For writev, the iovec structure is defined as 

struct iovec { 

caddr„t iov_base; 
int iovjen; 

}; 

Each iovec entry specifies the base address and length of an area in memory from which data ^ 

should be written, writev will always write a complete area before proceeding to the next. I 

On objects capable of seeking, the write starts at a position given by the pointer associated 
with d, see lseek(2). Upon return from write, the pointer is incremented by the number of 
bytes actually written. 

Objects that are not capable of seeking always write from the current position. The value of 
the pointer associated with such an object is undefined. 

If the real user is not the super-user, then write clears the set-user-id bit oh a file. This 
prevents penetration of system security by a user who "captures" a writable set-user-id file 
owned by the super-user. 

When using non-blocking I/O on objects such as sockets that are subject to flow control, write 
and writev may write fewer bytes than requested; the return value must be noted, and the 
remainder of the operation should be retried when possible. 

RETURN VALUE 

Upon successful completion the number of bytes actually written is returned. Otherwise a -1 
is returned and the global variable errno is set to indicate the error. 

ERRORS 

write and writev will fail and the file pointer will remain unchanged if one or more of the fol- 
lowing are true; 

[EBADF] D is not a valid descriptor open for writing. 

[EPIPE] An attempt is made to write to a pipe that is not open for reading by 

any process. 

[EPIPE] An attempt is made to write to a pocket of type SOCK_STREAM that is 

not connected to a peer socket. f 
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[EFBIG] 
[EFAULT] 



An attempt was made to write a file that exceeds the process's file size 
limit or the maximum file size. 



Part of iov or data to be written to the file points outside the process's 
allocated address space. 

The pointer associated with d was negative. 

There is no free space remaining on the file system containing the file. 

The user's quota of disk blocks on the file system containing the file has 
been exhausted. 

An I/O error occurred while reading from or writing to the file system. 

The file was marked for non-blocking I/O, and no data could be written 
immediately. 

In addition, writev may return one of the following errors: 

[EINVAL] iovcnt was less than or equal to 0, or greater than 16. 

[EINVAL] One of the iov Jen values in the iov array was negative. 

[EINVAL] The sum of the iov Jen values in the iov array overflowed a 32-bit 

integer. 

SEE ALSO 

fcntl(2), lseek(2), open(2), pipe(2), select(2) 



[EINVAL] 
[ENOSPC] 
[EDQUOT] 

[EIO] 
[EWOULDBLOCK] 
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NAME 

abort - generate a fault 

DESCRIPTION 

abort executes an instruction which is illegal in user mode. This causes a signal that normally 
terminates the process with a core dump, which may be used for debugging. 

SEE ALSO 

adb(l), sigvec(2), exit(2) 

DIAGNOSTICS 

Usually "Illegal instruction - core dumped" from the shell. 

ERRORS 

The abortQ function does not flush standard I/O buffers* Use fflush (3S). 
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NAME 

abort - terminate Fortran program 

SYNOPSIS 

call abort ( ) 

DESCRIPTION 

abort terminates the program that calls it, closing all open files truncated to the current posi- 
tion of the file pointer. The abort usually results in a core cump. 

DIAGNOSTICS 

When invoked, abort prints "Fortran abort routine called" on the standard error output. The 
shell prints the message "abort - core dumped" if a core dump results, 

SEE ALSO 

abort(3C) 

sh(l) in the User's Reference Manual 



( 



( 
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NAME 

abs - integer absolute value 

SYNOPSIS 

abs(i) 
int i; 

DESCRIPTION 

abs returns the absolute value of its integer operand. 

SEE ALSO 

floor(3M) for f abs 

ERRORS 

Applying the abs function to the most negative integer generates a result which is the most 
negative integer. That is, 

abs(0x80000000) 

returns 0x80000000 as a result. 
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NAME £ 

access - determine accessibility of a file V. 

SYNOPSIS 

integer function access (name, mode) 
character* (*) name, mode 

DESCRIPTION 

access checks the given file, name, for accessibility with respect to the caller according to 
mode, mode may include in any order and in any combination one or more of: 

r test for read permission 

w test for write permission 

x test for execute permission 

(blank) test for existence 

An error code is returned if either argument is illegal, or if the file cannot be accessed in all of 
the specified modes. is returned if the specified access would be successful. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

access(2), perror(3F) 

ERRORS 

Pathnames can be no longer than MAXPATHLEN as defined in <sy$/param.h>. 



( 



( 
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NAME 

alarm - schedule signal after specified time 

SYNOPSIS 

alarm (seconds) 
unsigned seconds; 

DESCRIPTION 

This interface is made obsolete by setitimer(2). 

>I alarm causes signal SIGALRM, see sigvec(2), to be sent to the invoking process in a 
number of seconds given by the argument. Unless caught or ignored, the signal terminates the 
process. 

Alarm requests are not stacked; successive calls reset the alarm clock. If the argument is 0, 
any alarm request is canceled. Because of scheduling delays, resumption of execution of when 
the signal is caught may be delayed an arbitrary amount. The longest specifiable delay time is 
2147483647 seconds. 

The return value is the amount of time previously remaining in the alarm clock. 

SEE ALSO 

sigpause(2), sigvec(2), signal(3C), sleep(3), ualarm(3), usleep(3) 
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NAME 

alarm - execute a subroutine after a specified time 

SYNOPSIS 

integer function alarm (time, proc) 
integer time 
external proc 

DESCRIPTION 

This routine arranges for subroutine 'proc to be called after time seconds. If time is "0", the 
alarm is turned off and no routine will be called. The returned value will be the time remain- 
ing on the last alarm. 

FILES 

/usr/lib/libU77,a 

SEE ALSO 

alarm(3C), sleep(3F), signal(3F) 

BUGS 

Alarm and sleep interact, If sleep is called after alarm, the alarm process will never be called. 
SIGALRM will occur at the lesser of the remaining alarm time or the sleep time. 



( 
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NAME 

asinh, acosh, atanh - inverse hyperbolic functions 

SYNOPSIS 

#include <math.h> 

double asinh (x) 
double x; 

double acosh (x) 
double x; 

double atanh (x) 
double x; 

DESCRIPTION 

These functions compute the designated inverse hyperbolic functions for real arguments. 

ERROR (due to Roundoff etc.) 

These functions inherit much of their error from loglp described in exp(3M). 

DIAGNOSTICS 

Acosh returns the default quiet NaN if the argument is less than 1. 

Atanh returns the default quiet NaN if the argument has absolute value bigger than or equal to 
1. 

SEE ALSO 

math(3M), exp(3M) 

AUTHOR 

W. Kahan, Kwok-Choi Ng 
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NAME £ 

assert - program verification ^- 

SYNOPSIS 

#iii dude <assert.h> 

assert(expression) 

DESCRIPTION 

assert is a macro that indicates expression is expected to be true at this point in the program. 
It causes an exit (2) with a diagnostic comment on the standard output when expression is false 
(0). Compiling with the <x(l) option -DNDEBUG effectively deletes assert from the program. 

DIAGNOSTICS 

'Assertion failed; file / line n.' f is the source file and n the source line number of the assert 
statement. 



c 
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NAME 

atof, atoi, atol - convert ASCII to numbers 

SYNOPSIS 

double atof(nptr) 
char *nptr; 

atoi(nptr) 
char *nptr; 

long atol(nptr) 
char *nptr; 

DESCRIPTION 

These functions convert a string pointed to by nptr to floating, integer, and long integer 
representation respectively. The first unrecognized character ends the string. 

atof recognizes an optional string of spaces, then an optional sign, then a string of digits 
optionally containing a decimal point, then an optional V or 'E' followed by an optionally 
signed integer. 

atoi and atol recognize an optional string of spaces, then an optional sign, then a string of 
digits. 

SEE ALSO 

scanf(3S) 

ERRORS 

There are no provisions for overflow. 
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NAME I 

bcopy, bcmp, bzero, Jffs - bit and byte string operations ^- 

SYNOPSIS 

bcopy(src 9 dst, length) 
char *src, *dst; 
int length; 

bcmp(bl ? fo2, length) 
char *bl, *b2; 
hit length; 

bzero(b, length) 
char *b; 
int length; 

ffs(i) 
int I; 

DESCRIPTION 

The functions bcopy, hemp, and hzero operate on variable length strings of bytes. They do 
not check for null bytes as the routines in string (3) do. 

bcopy copies length bytes from string sre to the string dst . 

hemp compares byte string hi against byte string hi , returning zero if they are identical, non- 
zero otherwise. Both strings are assumed to be length bytes long. 

hzero places length bytes in the string hi . 

ffs find the first bit set in the argument passed it and returns the index of that bit. Bits are 
numbered starting at 1. A return value of indicates the value passed is zero. | 

ERRORS 

The bcopy routine take parameters backwards from strcpy. 



MIPS Computer Systems, Inc. February 5, 1989 Page 1 



BYTEORDER ( 3N-BSD ) RISC/os Programmer's Reference BYTEORDER ( 3N-BSD ) 



NAME 

htonl, htons, ntohl, ntohs - convert values between host and network byte order 

SYNOPSIS 

#include <sys/types.h> 
#include <netinet/in.h> 

netlong = htonl (hostlong); 
ujong netlong, hostlong; 

net short = h tons (host short); 
u.short netshort, hostshort; 

hostlong = ntohl (netlong); 
ujong hostlong, netlong; 

hostshort = ntohs (netshort); 
u_short hostshort, netshort; 

DESCRIPTION 

These routines convert 16 and 32 bit quantities between network byte order host byte order. 
On machines such as the SUN these routines are defined as null macros in the include file 
<netinet/in.h>. 

These routines are most often used in conjunction with Internet addresses and ports as 
returned by gethosthyname(31Si) and getservent(3N). 

SEE ALSO 

gethostbyname(3N), getservent(3N) 

ERRORS 

The VAX handles bytes backwards from most everyone else in the world. This is not 
expected to be fixed in the near future. 
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NAME I 

chdir - change default directory 

SYNOPSIS 

integer function cjidir (dirname) 
character* (*) dirname 

DESCRIPTION 

The default directory for creating and locating files will be changed to dirname. Zero is 
returned if successful; an error code otherwise. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

chdir(2), cd(l), perror(3F) 

BUGS 

Pathnames can be no longer than MAXPATHLEN as defined in <sy$/param.h>. 

Use of this function may cause inquire by unit to fail. 



( 



( 
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NAME 

chmod - change mode of a file 

SYNOPSIS 

integer function chmod (name, mode) 
character* (*) name, mode 

DESCRIPTION 

This function changes the filesystem mode of file name. Mode can be any specification recog- 
nized by chmod (1). Name must be a single pathname. 

The normal returned value is 0. Any other value will be a system error number. 

FILES 

/usr/lib/libU77.a 

/bin/chmod exec'ed to change the mode. 

SEE ALSO 

chmod(l) 

BUGS 

Pathnames can be no longer than MAXPATHLEN as defined in <$ys/param.h> . 
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NAME 

crypt, setkey, encrypt - DES encryption 

SYNOPSIS 

char *crypt(key, salt) 
char *key ? *salt; 

setkey (key) 
char *key; 

encrypt(block ? edflag) 
char *block; 

cc ..♦ -krypt 

DESCRIPTION 

NOTE: By default, setkey is not available, and encrypt ignores the value of edflag (it is always 
treated as 0). Standard versions of these routines are available in the crypt library 
(/usr/lib/libcrypta), which is available in the USA version of UMIPS-BSD. 

crypt is the password encryption routine. It is based on the NBS Data Encryption Standard, 
with variations intended (among other things) to frustrate use of hardware implementations of 
the DES for key search. 

The first argument to crypt is normally a user's typed password. The second is a 2-character 
string chosen from the set [a-zA-ZO-97]. The salt string is used to perturb the DES algorithm 
in one of 4096 different ways, after which the password is used as the key to encrypt repeat- 
edly a constant string. The returned value points to the encrypted password, in the same 
alphabet as the salt. The first two characters are the salt itself. 

The other entries provide (rather primitive) access to the actual DES algorithm. The argument 
of setkey is a character array of length 64 containing only the characters with numerical value 
and 1. If this string is divided into groups of 8, the low-order bit in each group is ignored, 
leading to a 56-bit key which is set into the machine. 

The argument to the encrypt entry is likewise a character array of length 64 containing ? s and 
l's. The argument array is modified in place to a similar array representing the bits of the 
argument after having been subjected to the DES algorithm using the key set by setkey. If 
edflag is 0, the argument is encrypted; if non-zero, it is decrypted. 

SEE ALSO 

passwd(l), passwd(5), login(l), getpass(3) 

ERRORS 

The return value points to static data whose content is overwritten by each call. 



( 



( 



( 
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NAME 

ctime, localtime, gmtime, asctime, timezone, tzset - convert date and time to ASCII 

SYNOPSIS 

void tzset 

char *ctime (clock) 
time_t *clock; 

#include <time.h> 

char *a$ctime(tm) 
struct tm *tm; 

struct tm *localtime (clock) 
time_t *eloek; 

struct tm *gm time (clock) 
time_t *clock; 

char *timezone(zone, dst) 

DESCRIPTION 

tzset uses the value of the environment variable TZ to set up the time conversion information 
used by localtime. 

If TZ.does not appear in the environment, the TZDEFAULT file (as defined in tzfile.h) is used 
by localtime. If this file fails for any reason, the GMT offset as provided by the kernel is used. 
In this case, DST is ignored, resulting in the time being incorrect by some amount if DST is 
currently in effect. If this fails for any reason, GMT is used. 

If TZ appears in the environment but is value is a null string. Greenwich Mean Time is used; 
if TZ appears and begins with a slash, it is used as the absolute pathname of the tzfile(5y 
format file from which to read the time conversion information; if TZ appears and begins with 
a character other than a slash, it's used as a pathname relative to the system time conversion 
information directory, defined as TZDIR in the include file tzfile.h. If this file fails for any rea- 
son, GMT is used. 

Programs that always wish to use local wall clock time should explicitly remove the environ- 
mental variable TZ with unsetenv (3). 

ctime converts a longer integer, pointed to by clock, such as returned by time(3c) into ASCII 
and returns a pointer to a 26-character string in the following form. All the fields have con- 
stant width. 

Sun Sep 16 01:03:52 1973\n\0 

localtime and gmtime return pointers to structures containing the broken-down time, localtime 
corrects for the time zone and possible daylight savings time; gmtime converts directly to 
GMT, which is the time UNIT uses, asctime converts a broken-down time to ASCII and 
returns a pointer to a 26-character string. 

The structure declaration from the include file is: 



struct tm { 








int tm_sec; 


/* 0-59 


seconds */ 




int tm_min; 


/* 0-59 


minutes */ 




int tmjiour; 


/* 0-23 


hour */ 




int tm_mday; 


/* 1-31 


day of month */ 




int tmumon; 


/* 0-11 


month */ 




int tm_year; 


/*0- 


year - 1900 */ 




int tm_wday; 


/*0-6 


day of week (Sunday = 


= 0)*/ 


r Systems, Inc. 
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int tm_yday; /* 0-365 day of year */ 
kit tm_i$dst; /* flag: daylight savings time in effect */ 
char **tm_zone; /* abbreviation of timezone name */ 
long tm_gmtoff ; /* offset from GMT in seconds */ 

}; 

tmjsdst is non-zero if a time zone adjustment such as Daylight Savings time is in effect. 

tm_gmtoff is the offset (in seconds) of the time represented from GMT, with positive values 
indicating East of Greenwich. 

timezone remains for compatiability reasons only; it's impossible to reliably map timezone's 
arguments zone, a "mintutes west of GMT " value and dst, a "daylight saving time in effect" 
flag) to a time zone abbreviation. 

If the environmental string TZNAME exists, timezone returns its value, unless it consists of two 
comma separated strings, in which case the second string is returned if dst is non-zero, else 
the first string. If TZNAME doesn't exist, zone is checked for equality with a built-in table of 
values, in which case timezone returns the time zone or daylight time zone abbreviation associ- 
ated with that value. If the requested zone does not appear in the table, the difference from 
GMT is returned; e.g., in Afganistan, timezone(-(60*4+30), 0) is appropriate because it is 4:30 
ahead of GMT, and the return string GMT+430 is returned. Programs that in the past used the 
timezone function should return the zone name as set by localtime to assure correctness. 



FILES 



/etc/zoneinfo time zone information directory 

/etc/zoneinfo/localtime local time zone file 



SEE ALSO 
NOTE 



SO 

gettimeofday(2), getenv(3), time(3c), tzfile(5), environ(7) I 



The return values point to static data whose content is overwritten by each call. The tmuzpne 
field of a returned struct tm points to a static array of characters, which will also be overwrit- 
ten at the next call (and by calls to tzset). 



( 



Page 2 February 5, 1989 MIPS Computer Systems, Inc. 



CTYPE(3-BSD) 



RISC/os Programmer's Reference 



CTYPE(3-BSD) 



NAME 

isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, isgraph, iscntrl, 
isascii, toupper, tolower, toascii - character classification macros 

SYNOPSIS 

#include <ctype.h> 

isalpha (c) 

DESCRIPTION 

These macros classify ASCII coded integer values by table lookup. Each is a predicate return- 
ing nonzero for true, zero for false, isascii and toascii are defined on all integer values; the 
rest are defined only where isascii is true and on the single non- ASCII value EOF (see 
stdio (3S)). 

c is a letter 

c is an upper case letter 

c is a lower case letter 



isalpha 

isupper 

islower 

isdigit 

isxdigit 

isalnum 

isspace 

ispunct 

isprint 

isgraph 

iscntrl 

isascii 

tolower 

toupper 

toascii 

SEE ALSO 

ascii(7) 



c is a digit 

c is a hex digit 

c is an alphanumeric character 

c is a space, tab, carriage return, newline, vertical tab, or formfeed 

c is a punctuation character (neither control nor alphanumeric) 

c is a printing character, code 040(8) (space) through 0176 (tilde) 

c is a printing character, similar to isprint except false for space. 

c is a delete character (0177) or ordinary control character (less than 
040). 

c is an ASCII character, code less than 0200 

c is converted to lower case. Return value is undefined if not isupper (c). 

c is converted to upper case. Return value is undefined if not islower (c). 

c is converted to be a valid ascii character. 
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NAME 



curses - screen functions with "optimal" cursor motion 



( 



SYNOPSIS 

cc [ flags ] files —Icurses -™ltermcap [ libraries ] 

DESCRIPTION 

These routines give the user a method of updating screens with reasonable optimization. They 
keep an image of the current screen, and the user sets up an image of a new one. Then the 
refresh () tells the routines to make the current screen look like the new one. In order to ini- 
tialize the routines, the routine initscrQ must be called before any of the other routines that 
deal with windows and screens are used. The routine endwinQ should be called before exiting. 

SEE ALSO 

Screen Updating and Cursor Movement Optimization: A Library Package, Ken Arnold, 
ioctl(2), getenv(3), tty(4), termcap(5) 

AUTHOR 

Ken Arnold 



FUNCTIONS 

addch(ch) 

addstr(str) 

box(win,vert,hor) 

cbreakQ 

clearQ 

clearok(scr,boolf) 

clrtobotQ 

clrtoeolQ 

delchQ 

deletelnQ 

delwin(win) 

echoQ 

endwinQ 

eraseQ 

flusok(win,boolf) 

getch() 

getcap(name) 

getstr(str) 

gettmodeQ 

getyx(win,y,x) 

inch() 

initscrQ 

insch(c) 

insertlnQ 

leaveok(win,boolf) 

longname(termbuf,name) 

move(y,x) 

mvcur(lasty,lastx,newy,newx) 

newwin(lines,cols,begin_y,begin„x) 

mo 

nocbreakQ 

noechoQ 

nonlQ 

norawQ 

overlay(winl , win2) 



add a character to stdscr 

add a string to stdscr 

draw a box around a window 

set cbreak mode 

clear stdscr 

set clear flag for scr 

clear to bottom on stdscr 

clear to end of line on stdscr 

delete a character 

delete a line 

delete win 

set echo mode 

end window modes 

erase stdscr 

set flush-on-refresh flag for win 

get a char through stdscr 

get terminal capability name 

get a string through stdscr 

get tty modes 

get (y,x) co-ordinates 

get char at current (y,x) co-ordinates 

initialize screens 

insert a char 

insert a line 

set leave flag for win 

get long name from termhuf 

move to (y,x) on stdscr 

actually move cursor 

create a new window 

set newline mapping 

unset cbreak mode 

unset echo mode 

unset newline mapping 

unset raw mode 

overlay winl on win2 
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overwrite(winl,win2) 

printw(f mt ,argl , arg2, . . .) 

raw() 

refresh() 

resetty() 

savettyQ 

scanw(fmt,argl,arg2,...) 

scroll(win) 

scrollok(win,boolf) 

setterm(name) 

standend() 

standoutQ 

subwin(win,lines,cols,begin_y,begin_x) 

touchline(win,y, sx,ex) 

touchoverlap(winl,win2) 

touchwin(win) 

unctrl(ch) 

waddch(win,ch) 

waddstr(win,str) 

wclear(win) 

wclrtobot(win) 

wclrtoeol(win) 

wdelch(win,c) 

wdeleteln(win) 

werase(win) 

wgetch(win) 

wgetstr(win,str) 

winch(win) 

winsch(win,c) 

winsertln(win) 

wmove(win,y,x) 

wprintw(win,fmt,argl,arg2, . . .) 

wrefresh(win) 

wscanw(win,fmt,argl,arg2, . . .) 

wstandend(win) 

wstandout(win) 



overwrite winl on top of win2 

printf on stdscr 

set raw mode 

make current screen look like stdscr 

reset tty flags to stored value 

stored current tty flags 

scanf through stdscr 

scroll win one line 

set scroll flag 

set term variables for name 

end standout mode 

start standout mode 

create a subwindow 

mark line y sx through sy as changed 

mark overlap of winl on winl as changed 

"change" all of win 

printable version of ch 

add char to win 

add string to win 

clear win 

clear to bof torn of win 

clear to end of line on win 

delete char from win 

delete line from win 

erase win 

get a char through win 

get a string through win 

get char at current (y,x) in win 

insert char into win 

insert line into win 

set current (y ? x) co-ordinates on win 

printf on win 

make screen look like win 

scanf through win 

end standout mode on win 

start standout mode on win 



ERRORS 
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NAME I 

disassembler - disassemble a MIPS instruction and print the results ^ 

SYNOPSIS 

int disassembler (iadr, regstyle, get^symname, get^regvalue, geUbytes, printjieader) 

unsigned iadr; 

int regstyle; 

char *(*geCsymname)(); 

int (*get_jregvalue)(); 

long (*get3ytes)(); 

void (*printjieader)(); 

DESCRIPTION 

Disassembler disassembles and prints a MIPS machine instruction on stdout. 

Iadr is the instruction address to be disassembled. Regstyle specifies how registers are named 
in the disassembly; if the value is 0/ compiler names are used; otherwise, hardware names are 
used. 

The next four arguments are function pointers, most of which give the caller some flexibility in 
the appearance of the disassembly. The only function that MUST be provided is getjbytes. All 
other functions are optional. Getjbytes is called with no arguments and returns the next 
byte(s) to disassemble, 

Get^symname is passed an address, which is the target of a jal instruction. If NULL is returned 
or if get_symname is NULL, the disassembler prints the address; otherwise, the string name is 
printed as returned from get^symname. If get_jegvalue is not NULL, it is passed a register 
number and returns the current contents of the specified register. Disassembler prints this 
information along with the instruction disassembly. If print Jieader is not NULL, it is passed £ 

the instruction address iadr and the current instruction to be disassembled, which is the return ^ 

value from getj>ytes. Print Jieader can use these parameters to print any desired information 
before the actual instruction disassembly is printed. 

If getj>ytes is NULL, the disassembler returns 4 and errno is set to EINVAL; otherwise, the 
number of bytes that were disassembled is returned. If the disassembled word is a jump or 
branch instruction, the instruction in the delay slot is also disassembled. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldfcn(4). 



( 
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NAME 

dbminit, fetch, store, delete, firstkey, nextkey - data base subroutines 

SYNOPSIS 

#include <dbm.h> 

typedef struct { 

char *dptr; 

int dsize; 
} datum; 

dbminit (file) 
char *file; 

datum fetch (key) 
datum key; 

store (key, content) 
datum key, content; 

delete (key) 
datum key; 

datum firstkeyO 

datum nextkey(key) 
datum key; . 

dbmcloseQ 

DESCRIPTION 

Note: the dhm library has been superceded by ndbm (3), and is now implemented using 
ndbm. These functions maintain key/content pairs in a data base. The functions will handle 
very large (a billion blocks) databases and will access a keyed item in one or two file system 
accesses. The functions are obtained with the loader option — Idbm. 

keys and contents are described by the datum typedef. A datum specifies a string of dsize 
bytes pointed to by dptr. Arbitrary binary data, as well as normal ASCII strings, are allowed. 
The data base is stored in two files. One file is a directory containing a bit map and has '.dir' 
as its suffix. The second file contains all data and has '.pag' as its suffix. 

Before a database can be accessed, it must be opened by dbminit. At the time of this call, the 
files file. dir and file. pag must exist. (An empty database is created by creating zero-length 
'.dir' and '.pag' files.) 

Once open, the data stored under a key is accessed by fetch and data is placed under a key by 
store. A key (and its associated contents) is deleted by delete. A linear pass through all keys 
in a database may be made, in an (apparently) random order, by use of firstkey and nextkey. 
Firstkey will return the first key in the database. With any key nextkey will return the next key 
in the database. This code will traverse the data base: 

for (key = firstkeyQ; key. dptr != NULL; key = nextkey(key)) 

The routine dbmclose closes the current database. 

DIAGNOSTICS 

All functions that return an int indicate errors with negative values. A zero return indicates 
ok. Routines that return a datum indicate errors with a null (0) dptr. 

SEE ALSO 

ndbm (3) 
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ERRORS 

The '.pag ? file will contain holes so that its apparent size is about four times its actual content. 
Older UNIX systems may create real file blocks for these holes when touched. These files 
cannot be copied by normal means (cp, cat, tp, tar, ar) without filling in the holes. 

dptr pointers returned by these subroutines point into static storage that is changed by subse- 
quent calls. 

The sum of the sizes of a key/content pair must not exceed the internal block size (currently 
1024 bytes). Moreover all key/content pairs that hash together must fit on a single block. 
store will return an error in the event that a disk block fills with inseparable data. 

delete does not physically reclaim file space, although it does make it available for reuse. 

The order of keys presented by firstkey and nextkey depends on a hashing function f not on 
anything interesting. 



c 
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NAME 

opendir, readdir, telldir, seekdir, rewinddir, closedir - directory operations 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/dir.h> 

DIR *opendir(filename) 
char ^filename; 

struct direct *readdir(dirp) 
DIR *dirp; 

long telldir (dirp) 
DIR *dirp; 

seekdir(dirp, loc) 
DIR *dirp; 
long loc; 

rewinddir (dirp) 
DIR *dirp; 

closedir(dirp) 
DIR *dirp; 

DESCRIPTION 

opendir opens the directory named by filename and associates a directory stream with it. open- 
dir returns a pointer to be used to identify the directory stream in subsequent operations. The 
pointer NULL is returned if filename cannot be accessed, or if it cannot malloc(3) enough 
memory to hold the whole thing. 

readdir returns a pointer to the next directory entry. It returns NULL upon reaching the end 
of the directory or detecting an invalid seekdir operation. 

telldir returns the current location associated with the named directory stream. 

seekdir sets the position of the next readdir operation on the directory stream. The new posi- 
tion reverts to the one associated with the directory stream when the telldir operation was per- 
formed. Values returned by telldir are good only for the lifetime of the DIR pointer from 
which they are derived. If the directory is closed and then reopened, the telldir value may be 
invalidated due to undetected directory compaction. It is safe to use a previous telldir value 
immediately after a call to opendir and before any calls to readdir. 

rewinddir resets the position of the named directory stream to the beginning of the directory. 

closedir closes the named directory stream and frees the structure associated with the DIR 
pointer. 

Sample code which searchs a directory for entry "name" is: 

len = strlen(name); 
dirp = opendir("."); 
for (dp = readdir(dirp); dp != NULL; dp - readdir(dirp)) 

if (dp->d_namlen =*= len && !strcmp(dp->d_name, name)) { 

closedir(dirp); 

return FOUND; 

} 
closedir(dirp); 

return NOT_FOUND; 
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SEE ALSO 

open(2), close(2), read(2), lseek(2), dir(5) 
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NAME 

ecvt, fcvt, gcvt - output conversion 

SYNOPSIS 

char *ecvt(value 9 ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, *sign; 

char *fcvt(value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, *sign; 

char *gcvt(value, ndigit, buf) 
double value; 
char *buf; 

DESCRIPTION 

ecvt converts the value to a null-terminated string of ndigit ASCII digits and returns a pointer 
thereto. The position of the decimal point relative to the beginning of the string is stored 
indirectly through decpt (negative means to the left of the returned digits). If the sign of the 
result is negative, the word pointed to by sign is non-zero, otherwise it is zero. The low-order 
digit is rounded. 

fcvt is identical to ecvt, except that the correct digit has been rounded for Fortran F-format 
output of the number of digits specified by ndigits, 

gcvt converts the value to a null-terminated ASCII string in buf and returns a pointer to buf. It 
attempts to produce ndigit significant digits in Fortran F format if possible, otherwise E for- 
mat, ready for printing. Trailing zeros may be suppressed. 

SEE ALSO 

printf(3) 

ERRORS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

emulate_branch - MIPS branch emulation 

SYNOPSIS 

#include <signaLh> 

emulatejbranch(sep f branch_instnictioii) 

struct sigcontext *scp; 

unsigned long branch_instruction; 

executejbranch (foranch_jnstruction) 
unsigned long branchjnstructlon; 

DESCRIPTION 

emulate Joranch is passed a signal context structure and a branch instruction. It emulates the 
branch based on the register values in the signal context structure. It modifies the value of the 
program counter in the signal context structure {scjpc) to the target of the branch instruction. 
The program counter must initially be pointing at the branch and the register values must be 
those at the time of the branch. If the branch is not taken the program counter is advanced 
to point to the instruction after the delay slot (sc__pc += 8). 

In the case the branch instruction is a branch on coprocessor 2 or 3 instruction emulate Jhranch 
calls executejyranch to execute the branch in data space to determine if it is taken or not. 
can't emulate or execute the branch currently. 

RETURN VALUE 

emulatejbranch returns a if the branch was emulated successfully. An non-zero value indi- 
cates the value passed as a branch instruction was not a branch instruction. 

executejbranch returns non-zero on taken branches and zero on non-taken branches. 

ALSO SEE 

sigvec(2), cache_flush(3) signal(2) ? sigset(2) 

ERRORS 

Since executejbranch in only intended to be used by emulatejbranch it does not check it's 
parameter to see if in fact it is a branch instruction. It is really a stop gap in case a coproces- 
sor is added without the kernel fully supporting it (which is unlikely). 



( 
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NAME 

emulate_branch - MIPS branch emulation 

SYNOPSIS 

#include <signal.h> 

emulatejbranch (scp, branchjnstruction) 

struct sig context *scp; 

unsigned long branchjnstruction; 

DESCRIPTION 

Emulate _branch is passed a signal context structure and a branch instruction. It emulates the 
branch based on the register values in the signal context structure. It modifies the value of the 
program counter in the signal context structure (sc_pc) to the target of the branch instruction. 
The program counter must initially be pointing at the branch and the register values must be 
those at the time of the branch. If the branch is not taken the program counter is advanced 
to point to the instruction after the delay slot (sc^pc += 8). 

In the case the branch instruction is a branch on coprocessor 2 or 3 instruction emulatejbranch 
can't emulate or execute the branch currently. 

RETURN VALUE 

Emulatejbranch returns a if the branch was emulated successfully. An non-zero value indi- 
cates the value passed as a branch instruction was not a branch instruction. 

ALSO SEE 

signal(2), sigset(2) 
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NAME 

end, etext, edata - last locations in program 

eprol, J:text, J:data, _fbss - first locations in program 

__procedure__table, _procedure_table_size, _procedure_string_table - runtime procedure table 

SYNOPSIS 

#include <sym$*h> 

extern _END; 

extern JETEXT; 

extern „EDATA; 

extern eprol; 

extern JFTEXT; 

extern JFD ATA; 

extern „FBSS; 

extern J?ROCEDURE„TABLE; 

extern _PROCEDURE_TABLE_SIZE; 

extern _PROCEDURE_STRING_TABLE; 

DESCRIPTION 

These names refer neither to routines nor to locations with interesting contents except for 
J?ROCEDURE_TABLE and „PROCEDURE_STRING_TABLE. Except for eprol these are all 
names of loader defined symbols. The address of JETEXT is the first address above the pro- 
gram text, JBDATA is above the initialized data region, JBND is above the uninitialized data 
region, and eprol is the first instruction of the user's program that follows the runtime startup 
routine. 

When execution begins, the program break coincides with __END, but it is reset by the routines 

brk(2), malloc(3), standard input/output ($tdio(3)), the profile (— p) option of cc(l), etc. The / 

current value of the program break is reliably returned by 'sbrk(0) ? , see brk(2). V 

The loader defined symbols _PROCEDURE_TABLE, JPROCEDUREJTABLEJSIZE and 
JPROCEDURE_STRING_TABLE refer to the data structures of the runtime procedure table. 
Since these are loader defined symbols the data structures are build by Id (I) only if they are 
referenced. See the include file <sym.h> for the definition of the runtime procedure table 
and see the include file <exception.h> for its uses. 

SEE ALSO 

brk(2), malloc(3) 
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NAME 

end, etext, edata - last locations in program 

eprol, _ftext, _idata, Jfbss - first locations in program 

_4>rocedure_table, _procedure_table_size, _procedure_string_table - runtime procedure table 

SYNOPSIS 

#include <syms.h> 

extern _END; 

extern JETEXT; 

extern JEDATA; 

extern eprol; 

extern JETEXT; 

extern _FDATA; 

extern JFBSS; 

extern JPROCEDUREJTABLE; 

extern _PROCEDURE_TABLE_SIZE; 

extern _PROCEDURE_STRING_TABLE; 

DESCRIPTION 

These names refer neither to routines nor to locations with interesting contents except for 
J>ROCEDURE_TABLE and _PROCEDURE_STRING_TABLE. Except for eprol these are all 
names of loader defined symbols. The address of _ETEXT is the first address above the pro- 
gram text, J3DATA is above the initialized data region, _END is above the uninitialized data 
region, and eprol is the first instruction of the user's program that follows the runtime startup 
routine. 

When execution begins, the program break coincides with _END, but it is reset by the routines 
brk(2), malloc(3), standard input/output (stdio(3)), the profile (— p) option of cc(l), etc. The 
current value of the program break is reliably returned by 'sbrk(oy, see brk(2). 

The loader defined symbols _PROCEDURE_TABLE, _i>ROCEDURE_TABLE_SIZE and 
JPROCEDURE_STRING_TABLE refer to the data structures of the runtime procedure table. 
Since these are loader defined symbols the data structures are build by ld(l) only if they are 
referenced. See the include file <sym.h> for the definition of the runtime procedure table 
and see the include file <exception,h> for its uses. 

SEE ALSO 

brk(2), malloc(3) 
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NAME 

ethers, ether_ntoa ? ether_aton ? ether_ntohost, ether_hostton ? etherjine - Ethernet address 
mapping operations 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/$ocket»h> 
#include <net/if,h> 
#include <netinet/in.h> 
#include < netinet/if_ether.h > 

char * 
ether_ntoa(e) 

struct ether_&ddr *e; 

struct ether„addr * 
ether_aton(s) 

char *s; 

ether_ntohost(hostname, e) 
char *hostname; 
struct ether_addr *e; 

ether„hostton(hostoame 9 e) 

char *hostname; 
struct ether_addr *e; 

ether Jine(l, e, hostname) 

char *1; 

struct ether_addr m; 

char ^hostname; 

DESCRIPTION 

ether_ntoa ? etherjaton, etherjtohost, ether_hostton ? ether_line 

The$e routines are useful for mapping 48 bit Ethernet numbers to their ASCII representations 
or their corresponding host names, and vice versa. 

The function ether jntoa converts a 48 bit Ethernet number pointed to by e to its standard 
ASCII+1 representation; it returns a painter to the ASCII string. The representation is of the form: 
"x:x:x:x:x:x" where x is a hexadecimal number between and ff. The function ether jetton con- 
verts an ASCII string in the standard representation back to a 48 bit Ethernet number; the 
function returns NULL if the string cannot be scanned successfully. 

The function ether jxtohost maps an Ethernet number (pointed to by e) to its associated host- 
name. The string pointed to by hostname must be long enough to hold the hostname and a 
null character. The function returns zero upon success and non-zero upon failure. Inversely, 
the function ether Jiostton maps a hostname string to its corresponding Ethernet number; the 
function modifies the Ethernet number pointed to by e. The function also returns zero upon 
success and non-zero upon failure. 

The function ether Jine scans a line (pointed to by /) and sets the hostname and the Ethernet 
number (pointed to by e). The string pointed to by hostname must be long enough to hold 
the hostname and a null character. The function returns zero upon success and non-zero 
upon failure. The format of the scanned line is described by ether${5). 



FILES 



/etc/ethers (or the yellowpages' maps ethers. byaddr and ethers. byname) 



c 



c 



( 



MIPS Computer Systems, Inc. February 5, 1989 Page 1 



ETHERS ( 3N-BSD ) RISC/os Programmer's Reference ETHERS ( 3N-BSD ) 



SEE ALSO 

ethers (5) 
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NAME 

erf, erfc - error functions 

SYNOPSIS 

#include <math.h> 

double erf(x) 
double x; 

double erfc(x) 
double x; 

DESCRIPTION 

Erf (x) returns the error function of x; where erf (x) :* (2/V^)/oexp(~t 2 )dt. 

Erfc (x) returns 1.0-erf(x). 

The entry for erfc is provided because of the extreme loss of relative accuracy if erf(x) is 
called for large x and the result subtracted from 1. (e.g. for x * 10, 12 places are lost), 

SEE ALSO 

math(3M) 



( 
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NAME 

etime, dtime - return elapsed execution time 

SYNOPSIS 

function etime (tarray) 
real tarray(2) 

function dtime (tarray) 
real tarray(2) 

DESCRIPTION 

These two routines return elapsed runtime in seconds for the calling process. Dtime returns 
the elapsed time since the last call to dtime, or the start of execution on the first call. 

The argument array returns user time in the first element and system time in the second ele- 
ment. The function value is the sum of user and system time. 

The resolution of all timing is 1/HZ sec. where HZ is currently 60. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

times(2) 
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NAME 

examples - library of sample programs 

SYNOPSIS 

examples 

DESCRIPTION 

examples is a library containing sample programs to illustrate Ada language use and 
demonstrate the capabilities of the language, including those provided by the packages in the. 
standard, verdixlib, m\d publiclib libraries. 

Note: programs in the examples are neither supported nor warranted by MIPS. 

The directory contains the program files listed below. 



( 



FILES 



arguments.a uses package . COMMAND JLINE from verdixlib to print program 

arguments and environment variables. 

date uses package CALENDAR from standard to print current date and 

time, 

hanoi,a, termbody.a, termspec.a 

demonstrates solution to "Towers of Hanoi" problem. 

hello a typical first program, which uses package TEXTJO from standard to 

print the message "hello, world", 

mortgage. a uses package MATH from verdixlib to calculate mortgage payments. 

queens, a provides a solution of the "8 Queens" chess problem generalized for any 

board with sides of 4-12 squares. 

randoms uses packages CALENDAR from standard to create pseudo-random 

numbers. 

sUdeshow.a uses the package CURSES in publiclib and illustrates background tasks. 

sort^file sorts lines in a file within specifies columns. 

sortjnteger.a uses packages ORDERING form verdixlib to sort input of 10 integer in 

ascending and descending order. 

uc.p, uctran.a uses package CALENDAR from standard to maintain a calendar file; 

these illustrate the translation of a program from Pascal to Ada. uc.p is 
in Pascal, and uctran.a is a close translation of UC.PAS to Ada. 



/usr/vads5/examplesh 

SEE ALSO 

publiclib, standard, verdixlib 
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NAME 

execl, execv, execle, execlp, execvp, exec, execve, exect, environ - execute a file 

SYNOPSIS 

execl (name, argO, argl, ..., argn, 0) 
char *name, *arg0, *argl, ..., *argn; 

execv(name, argv) 
char *name, *argvQ; 

execle(name, argO, argl, ... ? argn, 0, envp) 
char *name, *arg0, *argl, ..., *argn, *envpD> 

exect(name, argv, envp) 
char *name, *argv[]> *envpQ; 

extern char **environ; 

DESCRIPTION 

These routines provide various interfaces to the execve system call. Refer to execve (2) for a 
description of their properties; only brief descriptions are provided here. 

exec in all its forms overlays the calling process with the named file, then transfers to the entry 
point of the core image of the file. There can be no return from a successful exec; the calling 
core image is lost. 

The name argument is a pointer to the name of the file to be executed. The pointers arg[0], 
arg[l] ... address null-terminated strings. Conventionally arg[0] is the name of the file. 

Two interfaces are available, execl is useful when a known file with known arguments is being 
called; the arguments to execl are the character strings constituting the file and the arguments; 
the first argument is conventionally the same as the file name (or its last component). A 
argument must end the argument list. 

The execv version is useful when the number of arguments is unknown in advance; the argu- 
ments to execv are the name of the file to be executed and a vector of strings containing the 
arguments. The last argument string must be followed by a pointer. 

The exect version is used when the executed file is to be manipulated with ptrace(2). The pro- 
gram is forced to single step a single instruction giving the parent an opportunity to manipulate 
its state. On the VAX-11 this is done by setting the trace bit in the process status longword. 

When a C program is executed, it is called as follows: 

main(argc, argv, envp) 

int argc; 

char **argv, **envp; 

where argc is the argument count and argv is an array of character pointers to the arguments 
themselves. As indicated, argc is conventionally at least one and the first member of the array 
points to a string containing the name of the file, 

argv is directly usable in another execv because argv[argc] is 0. 

envp is a pointer to an array of strings that constitute the environment of the process. Each 
string consists of a name, an "=", and a null-terminated value. The array of pointers is ter- 
minated by a null pointer. The shell sh(l) passes an environment entry for each global shell 
variable defined when the program is called. See environ(7) for some conventionally used 
names. The C run-time start-off routine places a copy of envp in the global cell environ, which 
is used by execv and execl to pass the environment to any subprograms executed by the current 
program. 
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execlp and execvp are called with the same arguments as execl and execv, but duplicate the £ 

shelf s actions in searching for an executable file in a list of directories. The directory list is V. 

obtained from the environment. 



FILES 



/bin/sh shell, invoked if command file found by execlp or execvp 



SEE ALSO 

execve(2), fork(2), environ (7), csh(l) 

DIAGNOSTICS 

If the file cannot be found, if it is not executable, if it does not start with a valid magic 
number (see a.out(5)), if maximum memory is exceeded, or if the arguments require too much 
space, a return constitutes the diagnostic; the return value is -1, Even for the super-user, at 
least one of the execute-permission bits must be set for a file to be executed. 

ERRORS 

If execvp is called to execute a file that turns out to be a shell command file, and if it is impos- 
sible to execute the shell, the values of argv[0] and argv[-l] will be modified before return. 



( 



( 
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NAME 

exit - terminate a process after flushing any pending output 

SYNOPSIS 

exit(status) 
int status; 

DESCRIPTION 

exit terminates a process after calling the Standard I/O library function _cleanup to flush any 
buffered output, exit never returns. 

SEE ALSO 

exit(2), intro(3) 
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NAME 

exp, expml, log, loglO, loglp, pow - exponential, logarithm, power 

SYNOPSIS 

#include <mathuh> 

double exp(x) 
double x; 

float fexp (float x) 
float x; 

double expml (x) 
double x; 

float f expml (float x) 
float x; 

double log(x) 
double x; 

float flog (float x) 
float x; 

double loglO(x) 
double x; 

float floglO(float x) 
float x; 

double loglp (x) 
double x; 



( 



( 



float flog Ip (float x) 
float x; 

double pow(x ? y) 
double x ? y; 

DESCRIPTION 

Exp and fexp returns the exponential function of x for double and float data types respec- 
tively. 

Expml and fexpml returns exp(x)-l accurately even for tiny x for double and float data types 
respectively. 

Log and flog returns the natural logarithm of x for double and float data types respectively. 

LoglO and floglO returns the logarithm of x to base 10 for double and float data types respec- 
tively. 

Loglp and floglp returns log(l+x) accurately even for tiny x for double and float data types 
respectively. 

Pow(x,y) returns x y . 

ERROR (due to Roundoff etc.) 

exp(x), log(x), expml(x) and loglp(x) are accurate to within an ulp, and JoglO(x) to within 
about 2 ulps; an ulp is one [/nit in the Last Place. The error in pow(x,y) is below about 2 ulps 
when its magnitude i$ moderate, but increases as pow(x,y) approaches the over/underflow 
thresholds until almost as many bits could be lost as are occupied by the floating-point 
format's exponent field; 11 bits for IEEE 754 Double. No such drastic loss has been exposed 
by testing; the worst errors observed have been below 300 ulps for IEEE 754 Double. 
Moderate values of pow are accurate enough that pow(integer,integer) is exact until it is bigger f 
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than 2**53 for IEEE 754 Double. 

DIAGNOSTICS 

exp returns oo when the correct value would overflow, or the smallest non-zero value when the 
correct value would underflow. 

Log and loglO returns the default quiet NaN when x is less than zero indicating the invalid 
operation. Log and loglO returns -oo when x is zero. 

Pow returns oo when x is and y is non-positive, Pow returns NaN when x is negative and y 
is not an integer indicating the invalid operation. When the correct value for pow would 
overflow or underflow, pow returns ±oo or respectively. 

NOTES 

Pqw(x,0) returns x**0 = 1 for all x including x = 0, oo , and NaN. Previous implementations of 
pow may have defined x**0 to be undefined in some or all of these cases. Here are reasons 
for returning x**0 = 1 always: 

(1) Any program that already tests whether x is zero (or infinite or NaN) before computing 
x**0 cannot care whether 0**0 = 1 or not. Any program that depends upon 0**0 to be 
invalid is dubious anyway since that expression's meaning and, if invalid, its consequences 
vary from one computer system to another. 

(2) Some Algebra texts (e.g. Sigler's) define x**Q = 1 for all x, including x = 0. This is compa- 
tible with the convention that accepts a[0] as the value of polynomial 

p(x) = a[0]*x**0 + a[l]*x**l + a[2]*x**2 +...+ a[n]*x**n 

at x - rather than reject a[0]*0**0 as invalid. 

(3) Analysts will accept 0**0 ~ 1 despite that x**y can approach anything or nothing as x and y 
approach independently. The reason for setting 0**0 = 1 anyway is this: 

If x(z) and y(z) are any functions analytic (expandable in power series) in z around z = 0, 
and if there x(0) = y(0) = 0, then x(z)**y(z) — ► 1 as z -* 0. 

(4) If 0**0 - 1, then oo**0 = 1/0**0 = 1 too; and then NaN**0 = 1 too because x**0 = 1 for all 
finite and infinite x, i.e., independently of x. 

SEE ALSO 

math(3M) 

AUTHOR 

Kwok-Choi Ng, W. Kahan 
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NAME 

fclose, fflush - close or flush a stream 

SYNOPSIS 

#inelude <st<lio.h> 

fclose (stream) 
FILE *stream; 

fflush (stream) 
FILE *stream; 

DESCRIPTION 

fclose causes any buffers for the named stream to be emptied, and the file to be closed. 
Buffers allocated by the standard input/output system are freed. 

fclose is performed automatically upon calling exit (3), 

fflush causes any buffered data for the named output stream to be written to that file. The 
stream remains open, 

SEE ALSO 

close(2), fopen(3S), setbuf(3S) 

DIAGNOSTICS 

These routines return EOF if stream is not associated with an output file, or if buffered data 
cannot be transferred to that file. 



( 



( 



( 
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NAME 

fdate - return date and time in an ASCII string 

SYNOPSIS 

subroutine fdate (string) 
character* (*) string 

character* (*) function fdate 

DESCRIPTION 

Fdate returns the current date and time as a 24 character string in the format described under 
crime (3). Neither 'newline' nor NULL will be included. 

Fdate can be called either as a function or as a subroutine. If called as a function, the calling 
routine must define its type and length. For example: 

character*24 fdate 
external fdate 

write(*,*) fdate() 



FILES 



/usr/lib/libU77.a 



SEE ALSO 

ctime(3), time(3F), itime(3F), idate(3F), ltime(3F) 



MIPS Computer Systems, Inc. February 13, 1989 Page 1 



FERROR C3S-BSD) RJSC/os Programmer's Reference FERROR ( 3S-BSD ) 



NAME. I 

f error, feof , clearerr, fileno - stream status inquiries ^ 

SYNOPSIS 

#include <stdio,h> 

feof($tream) 
file *stream; 

fei-rorOstream) 
FILE *$tream 

cle are it (stream) 
FILE *$trearo 

fileno(stream) 
FILE *$tream; 

DESCRIPTION 

feof returns non-zero when end of file is read on the named input stream, otherwise zero. 
Unless cleared by ckarerr, the end-of-file indication lasts until the stream is closed. 

f error returns non-zero when an error has occurred reading or writing the named stream, oth- 
erwise zero. Unless cleared by clearerr, the error indication lasts until the stream is closed. 

clear err resets the error and endoMle indicators on the named stream* 

fileno returns the integer file descriptor associated with the stream, see open (2). 

Currently all of these functions are implemented as macros; they cannot be redeclared. 

SEE ALSO 

fopen(3S) ? open(2) { 



( 
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NAME 

fabs, floor, ceil, rint - absolute value, floor, ceiling, and round-to-nearest functions 

SYNOPSIS 

#include <math.h> 

double floor (x) 
double x; 

float ffloor(float x) 
float x; 

double ceil(x) 
double x; 

float fceil(float x) 
float x; 

double trunc(x) 
double x; 

float ftrunc (float x) 
float x; 

double fabs(x) 
double x; 

double rint(x) 
double x; 

double fmod (x, y) 
double x, y; 

DESCRIPTION 

Floor and ffloor returns the largest integer no greater than x for double and float data types 
respectively. 

Ceil and fceil returns the smallest integer no less than x for double and float data types respec- 
tively. 

Trunc and ftrunc returns the integer (represented as a floating-point number) of x with the 
fractional bits truncated for double and float data types respectively. 

Fabs returns the absolute value |x|. 

Rint returns the integer (represented as a double precision number) nearest x in the direction 
of the prevailing rounding mode. 

Fmod returns the floating-point remainder of the division of x by y: zero if y is zero or if x/y 
would overflow; otherwise the number/ with the same sign as x, such that x = iy + /for some 
integer?, and |/| < \y\. 

NOTES 

In the default rounding mode, to nearest, rint(x) is the integer nearest x with the additional 
stipulation that if |rint(x)-x|=l/2 then rint(x) is even. Other rounding modes can make rint act 
like floor, or like ceil, or round towards zero. 

Another way to obtain an integer near x is to declare (in C) 

double x; int k; k = x; 
The MIPS C compilers rounds x towards to get the integer k. Also note that, if x is larger 
than k can accommodate, the value of k and the presence or absence of an integer overflow 
are hard to predict. 
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The routine fabs is in libc.a rather than libm.a. 

SEE ALSO 

abs(3), ieee(3M), math(3M) 



( 
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NAME 

flush - flush output to a logical unit 

SYNOPSIS 

subroutine flush flunit) 

DESCRIPTION 

Flush causes the contents of the buffer for logical unit lunit to be flushed to the associated file. 
This is most useful for logical units and 6 when they are both associated with the control ter- 
minal. 

FILES 

/usr/lib/libI77.a 

SEE ALSO 

fclose(3S) 
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NAME 

fork - create a copy of this process 

SYNOPSIS 

integer function forkO 

DESCRIPTION 

Fork creates a copy of the calling process. The only distinction between the 2 processes is 
that the value returned to one of them (referred to as the 'parent' process) will be the process 
id of the copy. The copy is usually referred to as the 'child' process. The value returned to 
the 'child' process will be zero. 

All logical units open for writing are flushed before the fork to avoid duplication of the con- 
tents of I/O buffers in the external file(s). 

If the returned value is negative, it indicates an error and will be the negation of the system 
error code, See perror(3F). 

A corresponding exec routine has not been provided because there is no satisfactory way to 
retain open logical units across the exec. However, the usual function of fork/exec can be per- 
formed using system (3F) . 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

fork(2), wait(3F), kill(3F), system(3F) ? perror(3F) 



c 
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NAME 

fopen, f reopen, fdopen - open a stream 

SYNOPSIS 

#include <stdio.h> 

FILE *fopen (filename, type) 
char ^filename, *type; 

FILE *freopen(filename ? type, stream) 
char ^filename, *type; 
FILE *stream; 

FILE *fdopen (tildes, type) 
char *type; 

DESCRIPTION 

fopen opens the file named by filename and associates a stream with it. fopen returns a pointer 
to be used to identify the stream in subsequent operations. 

type is a character string having one of the following values: 

V open for reading 

"w" create for writing 

"a" append: open for writing at end of file, or create for writing 

In addition, each type may be followed by a "+" to have the file opened for reading and writ- 
ing. "r+" positions the stream at the beginning of the file, "w+" creates or truncates it, and 
"a-f " positions it at the end. Both reads and writes may be used on read/write streams, with 
the limitation that an peek, rewind, or reading an end-of-file must be used between a read and 
a write or vice-versa. 

freopen substitutes the named file in place of the open stream . It returns the original value of 
stream. The original stream is closed. 

freopen is typically used to attach the preopened constant names, stdin, stdout, stderr, to 
specified files. 

fdopen associates a stream with a file descriptor obtained from open, dap, creat, or pipe (2). 
The type of the stream must agree with the mode of the open file. 

SEE ALSO 

open(2), fclose(3) 

DIAGNOSTICS 

fopen and freopen return the pointer NULL if filename cannot be accessed, if too many files are 
already open, or if other resources needed cannot be allocated. 

ERRORS 

fdopen is not portable to systems other than UNIX. 

The read/write types do not exist on all systems. Those systems without read/ write modes will 
probably treat the type as if the "+" was not present. These are unreliable in any event. 

In order to support the same number of open files as does the system, fopen must allocate 
additional memory for data structures using calloc after 20 files have been opened. This con- 
fuses some programs which use their own memory allocators. An undocumented routine, 
f_prealloc, may be called to force immediate allocation of all internal memory except for 
buffers. 
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NAME f 

fp„class - classes of IEEE floating-point values ^ 

SYNOPSIS 

#include <fp__class.h> 

int fp„class_d (double x); 
int fp_jclassjf (float x); 

DESCRIPTION 

These routines are used to determine the class of IEEE floating-point values. They return one 
of the constants in the file <fpjctass.h> and never cause an exception even for signaling 
NaN's. These routines are to implement the recommended function class(#) in the appendix 
of the IEEE 754-1985 standard for binary floating-point arithmetic. 

The constants in <fpjcla$s.h> refer to the following classes of values: 

Constant Class 

FP_SNAN Signaling NaN (Not^a-Number) 

FP_QNAN Quiet NaN (Not-a-Number) 

FPJPOSJNF +oo (positive infinity) 

FFJ>JEG_INF -oo (negative infinity) 

FPJPOS_NORM positive normalized non-zero 

FPJNEGJNORM negative normalized non-zero 

FPJPOSJDENORM positive cjenormalized 

FP_NEGJDENORM negative denormalized 

FPJPOSJZERO +0,0 (positive zero) f 

FPJN1EG_ZER0 -0.0 (negative zero) \ 

ALSO SEE 

ANSI/IEEE Std 754-1985, IEEE Standard for Binary Floating-Point Arithmetic 



( 
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NAME 

fp_class - classes of IEEE floating-point values 

SYNOPSIS 

#include <fp_class.h> 

int fp_class_d (double x); 
int fp_class_f (float x); 

DESCRIPTION 

These routines are used to determine the class of IEEE floating-point values. They return one 
of the constants in the file <fp_clas$.h> and never cause an exception even for signaling 
NaN's. These routines are to implement the recommended function class(*) in the appendix 
of the IEEE 754-1985 standard for binary floating-point arithmetic. 

The constants in <fp_clas$.h> refer to the following classes of values: 

Constant Class 

FP_SNAN Signaling NaN (Not-a-Number) 

FP.QNAN Quiet NaN (Not-a-Number) 

FPJPOSJNF +00 (positive infinity) 

FP_NEG JNF -00 (negative infinity) 

FP_POS_NORM positive normalized non-zero 

FP„NEG_NORM negative normalized non-zero 

FP_j>OS_DENORM positive denormalized 

FP_NEGJ3ENORM negative denormalized 

FP_POS_JZERO +0.0 (positive zero) 

FP_NEG_ZERO -0.0 (negative zero) 

ALSO SEE 

ANSI/IEEE Std 754-1985, IEEE Standard for Binary Floating-Point Arithmetic 



MIPS Computer Systems, Inc. February 5, 1989 Page 1 



FPC ( 3 ) RISC/os Programmer's Reference FPC ( 3 ) 



NAME £ 

fpc - floating-point control registers V 

SYNOPSIS 

#jnclude <sys/fpu.h> 

int get_fpc_csrO 

int set_fpc_csr(csr) 
int csr; 

int g-etJEjpcJrrO 

int get.Jpc_eir() 

void setjjpc Jed (value) 
int value; 

int swapRM(x) 
int x; 

int swapINX (x) 

int x; 

DESCRIPTION 

These routines are to get and set the floating-point control registers of MIPS floating-point 
units. All of these routines take and or return their values as 32 bit integers. 

The file <sys/fpuM> contains unions for each of the control registers. Each union contains a 
structure that breaks out the bit fields into the logical parts for each control register. This file 
also contains constants for fields of the control registers. 

All implementations of MIPS floating-point have a control and status register and a implemen- £ 

tation revsion register. The control and status register is returned by get_jpc__csr. The routine V 

setjpcjcsr sets the control and status register and returns the old value. The implementation 
revsion register is read-only and is returned by the routine get_fpcjrr. 

The R236Q floating-point units (floating-point boards) have two addtitonal control registers. 
The exception instruction register is a read-only register and is returned by the routine 
get\_fpC-.eir. The other floating-point control register on the R2360 is the leds register. The low 
8 bits corresponds to the leds where a one is off and a zero is on. The leds register is a write- 
only register and is set with the routine set_fpcjeds. 

The routine swapRN sets only the rounding mode and returns the old rounding mode. The 
routine swapINX sets only the sticky inexact bit and returns the old one. The bits in the argu- 
ments and return values to swapRN and swapINX are right justified. 

ALSO SEE 

R2010 Floating Point Coprocessor Architecture 
R2360 Floating Point Board Product Description 



( 
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NAME 

fpc - floating-point control registers 

SYNOPSIS 

#include <mips/fpu.h> 
#include <sys/fpu,h> 

int get_fpc_csrO 

_int set_fpc_csr(csr) 
int csr; 

int get_fpc_irrO 

int get_fpc_eir() 

void set_fpc_led (value) 
int value; 

int swapRM(x) 
int x; 

int swapINX(x) 
int x; 

DESCRIPTION 

These routines are to get and set the floating-point control registers of MIPS floating-point 
units. All of these routines take and or return their values as 32 bit integers. 

The file <mips/fpu.h> <sys/fpu.h> contains unions for each of the control registers. Each 
union contains a structure that breaks out the bit fields into the logical parts for each control 
register. This file also contains constants for fields of the control registers. 

All implementations of MIPS floating-point have a control and status register and a implemen- 
tation revsion register. The control and status register is returned by get__fpc_csr. The routine 
set_fpc_csr sets the control and status register and returns the old value. The implementation 
revsion register is read-only and is returned by the routine getjpcjrr. 

The R2360 floating-point units (floating-point boards) have two addtitonal control registers. 
The exception instruction register is a read-only register and is returned by the routine 
get_jpc„eir. The other floating-point control register on the R2360 is the leds register. The low 
8 bits corresponds to the leds where a one is off and a zero is on. The leds register is a write- 
only register and is set with the routine setjpcjeds. 

The routine swapRN sets only the rounding mode and returns the old rounding mode. The 
routine swapINX sets only the sticky inexact bit and returns the old one. The bits in the argu- 
ments and return values to swapRN and swapINX are right justified. 

ALSO SEE 

R2010 Floating Point Coprocessor Architecture 
R236G Floating Point Board Product Description 
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NAME 

fpi - floating-point interrupt analysis 

SYNOPSIS 

#inelude <fpi.h> 

void fpiQ 

void printJfpicountsO 

int fpilcounts^; 

char *fpi_listO; 
DESCRIPTION 

MIPS floating-point units generate floating-point interrupts for some classes of operations that 
occur with low frequency. In these cases the system software then emulates the operation in 
software. As a program takes floating-point interrupts its performance degrades since the 
operations are emulated in software. The routines and counters described here are used to 
analyze the causes of floating-point interrupts. 

The routine fpi makes a sysmips{2) [MIPSJFPS1GINT] system call to causes floating-point inter- 
rupts to generate a SIGFPE. It also sets up a special signal handler for SIGFPE's. On a 
floating-point interrupt that signal handler determines the precise cause of the interrupt and 
increments the appropriate counter mfpi_counts[]. 

The routine print _fpicounts prints out the value of the counters and their description on stderr 
as in the following example: 

source signaling NaN =*= 

source quiet NaN - 10 

source denormalized value = 23 

move of zero = 83 

negate of zero = 84 

implemented only in software =* 5 

invalid operation = 96 

divide by zero = 3837 

destination overflow = 398 

destination underflow - 489 
The constants in the file <fpi.h> along the counters, fpLcountsf], and the descriptive strings, 
fpiJist[J, can also be used to format messages. 

LIMITATIONS 

Fpi can't be used with programs that normally generate SIGFPE's. 
ALSO SEE 

R2010 Floating Point Coprocessor Architecture 
R2360 Floating Point Board Product Description 
sysmips(2) [MIPSJFPSIGINTR]. 



( 
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NAME 

fpi - floating-point interrupt analysis 

SYNOPSIS 

#include <fpi.h> 

yoid fpiO 

void printfpLcountsQ 

int fpLcountsQ; 

char *fpi_JistQ; 

DESCRIPTION 

MIPS floating-point units generate floating-point interrupts for some classes of operations that 
occur with low frequency. In these cases the system software then emulates the operation in 
software. As a program takes floating-point interrupts its performance degrades since the 
operations are emulated in software. The routines and counters described here are used to 
analyze the causes of floating-point interrupts. 

The routine fpi makes a fpjsigintr{2) sysmips(2) [MIPSJFPSIGXNT] system call to causes 
floating-point interrupts to generate a SIGFPE. It also sets up a special signal handler for 
SIGFPE's. On a floating-point interrupt that signal handler determines the precise cause of the 
interrupt and increments the appropriate counter in fpi_counts[]. 

The routine print Jpicounts prints out the value of the counters and their description on stderr 
as in the following example: 

source signaling NaN = 

source quiet NaN = 10 

source denormalized value = 23 

move of zero = 83 

negate of zero = 84 

implemented only in software = 5 

invalid operation = 96 

divide by zero = 3837 

destination overflow = 398 

destination underflow = 489 
The constants in the file <fpi.h> along the counters, fpLcount$[], and the descriptive strings, 
fpijist[], can also be used to format messages. 

LIMITATIONS 

fpi can't be used with programs that normally generate SIGFPE's. 

ALSO SEE 

R2010 Floating Point Coprocessor Architecture 
R2360 Floating Point Board Product Description 
fp_sigintr(2). sysmips(2) [MIPSJTSIGINTR]. 
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NAME 

fread, fwrite - buffered binary input/output 

SYNOPSIS 

#inclucle <stdio.h> 

fread (ptr, sizeof(*ptr), nitems, stream) 
FILE ^stream; 

fwrite(ptr, $izeof(*ptr), nitems, stream) 
FILE *stream; 

DESCRIPTION 

fread reads, into a block beginning at ptr, nitems of data of the type of *ptr from the named 
input stream. It returns the number of items actually read. 

If stream is stdin and the standard output is line buffered, then any partial output line will be 
flushed before any call to read (2) to satisfy the fread. 

fwrite appends at most nitems of data of the type of *ptr beginning at ptr to the named output 
stream ♦ It returns the number of items actually written. 

SEE ALSO 

read(2), write(2), fopen(3S), getc(3S), putc(3S), gets(3S), puts(3S), printf(3S), scanf(3S) 

DIAGNOSTICS 

fread and fwrite return upon end of 'file or error. 



( 
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NAME 

frexp, Idexp, modf - split into mantissa and exponent 

SYNOPSIS 

double frexp (value, eptr) 
double value; 
int *eptr; 

double Idexp (value, exp) 
double value; 

double modf(value, iptr) 
double value, *iptr; 

DESCRIPTION 

frexp returns the mantissa of a double value as a double quantity, x, of magnitude less than 1 
and stores an integer n such that value = x * 2 n indirectly through eptr. 

Idexp returns the quantity value *2? X P. 

modf returns the positive fractional part of value and stores the integer part indirectly through 
iptr. 
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NAME 

fseek, ftell - reposition a file on a logical unit 

SYNOPSIS 

integer function fseek (lunit, offset, from) 
integer offset, from 

integer function ftell (limit) 

DESCRIPTION 

lunit must refer to an open logical unit, offset is an offset in bytes relative to the position 
specified by from. Valid values for from are: 

meaning 'beginning of the file' 

1 meaning 'the current position' 

2 meaning 'the end of the file' 

The value returned by fseek will be if successful, a system error code otherwise. (See 
perror(3F)) 

Ftell returns the current position of the file associated with the specified logical unit. The value 
is an offset, in bytes, from the beginning of the file. If the value returned is negative, it indi- 
cates an error and will be the negation of the system error code. (See perror(3F)) 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

fseek(3S), perror(3F) 



( 



( 
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NAME 

fseek, ftell, rewind - reposition a stream 

SYNOPSIS 

#include <stdio.h> 

fseek(stream, offset, ptrname) 
FILE *stream; 
long offset; 

long ftell (stream) 
FILE *stream; 

rewind (stream) 

DESCRIPTION 

fseek sets the position of the next input or output operation on the stream. The new position 
is at the signed distance offset bytes from the beginning, the current position, or the end of the 
file, according as ptrname has the value 0, 1, or 2. 

fseek undoes any effects of ungetc (3S). 

ftell returns the current value of the offset relative to the beginning of the file associated with 
the named stream. It is measured in bytes on UNIX; on some other systems it is a magic 
cookie, and the only foolproof way to obtain an off set for fseek . 

rewind (stream) is functionally equivalent to fseek (stream , 0L, 0), but it does not return a use- 
ful return value. 

SEE ALSO 

lseek(2), fopen(3S) 

DIAGNOSTICS 

fseek returns -1 for improper seeks, otherwise zero. 
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NAME 

getarg ? iargc - return command line arguments 

SYNOPSIS 

subroutine getarg (k 9 arg) 
character* (*) arg 

function iargc 

DESCRIPTION 

A call to getarg will return the kth command line argument in character string arg. The Oth 
argument is the command name. 

large returns the index of the last command line argument, 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

getenv(3F) ? execve(2) 



c 

MIPS Computer Systems, Inc. February 13, 1989 Page 1 



GETC ( 3F ) RISC/os Programmer's Reference GETC ( 3F ) 



NAME 

getc, fgetc - get a character from a logical unit 

SYNOPSIS 

integer function getc (char) 
character char 

integer function fgetc (limit, char) 
character char 

DESCRIPTION 

These routines return the next character from a file associated with a fortran logical unit, 
bypassing normal fortran I/O. Getc reads from logical unit 5, normally connected to the con- 
trol terminal input. 

The value of each function is a system status code. Zero indicates no error occurred on the 
read; -1 indicates end of file was detected. A positive value will be either a UNIX system 
, error code or an f77 I/O error code. See perror(3F). 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

getc(3S), intro(2), perror(3F) 
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NAME 

getc, getchar, fgetc, getw - get character or word from stream 

SYNOPSIS 

#fnclude <stdio.h> 

int getc (stream) 
FILE *$tream; 

int getchar 

int fg etc (stream) 
FILE *stream; 

int getw (stream) 
FILE *stream; 

DESCRIPTION 

getc returns the next character from the named input stream. 

getcharQ is identical to getc(stdin). 

fgetc behaves like getc, but is a genuine function, not a macro; it may be used to save object 
text. 

getw returns the next int (a 32-bit integer on a VAX-11) from the named input stream. It 
returns the constant EOF upon end of file or error, but since that is a good integer value, feof 
and f error (3S) should be used to check the success of getw, getw assumes no special align- 
ment in the file. 

SEE ALSO 

clearerr(3S), fopen(3S), putc(3S), gets(3S), scanf(3S), fread(3S), ungetc(3S) 

DIAGNOSTICS 

These functions return the integer constant EOF at end of file, upon read error, or if an 
attempt is made to read a file not opened by fopen. The end-of-file condition is remembered, 
even on a terminal, and all subsequent attempts to read will return EOF until the condition is 
cleared with clearerr(3S). 

ERRORS 

Because it is implemented as a macro, getc treats a stream argument with side effects 
incorrectly. In particular, 'getc(*f++);' doesn't work sensibly. 



( 
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NAME 

getcwd - get pathname of current working directory 

SYNOPSIS 

integer function getcwd (dirname) 
character* (*) dirname 

DESCRIPTION 

The pathname of the default directory for creating and locating files will be returned in dir- 
name. The value of the function will be zero if successful; an error code otherwise. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

chdir(3F), perror(3F) 

BUGS 

Pathnames can be no longer than MAXPATHLEN as defined in <sys/param.h> , 
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NAME I 

getdiskbyname - get disk description by its name ^ 

SYNOPSIS 

#include <disktab.h> 

struct disktab * 
getdiskbyname (name) 
char *name; 

DESCRIPTION 

getdiskbyname takes a disk name (e.g. rm03) and returns a structure describing its geometry 
information and the standard disk partition tables. All information obtained from the disk- 
tab (5) file. 

<disktah.h> has the following form: 

/* , ___ , */ 

/* | Copyright Unpublished, MIPS Computer Systems, Inc. AH Rights | */ 
/* | Reserved. This software contains proprietary and confidential | */ 
/* | information of MIPS and its suppliers. Use, disclosure or | */ 
/* | reproduction is prohibited without the prior express written | */ 
7* | consent of MIPS. |*/ 

/* __ _ __ — , ^ — */ . 

/* SHeader: disktab.h,v 1.6 87/08/04 09:58:11 dee Exp $ */ 
/* disktab.h 4.3 83/08/11 */ 

/* £ 

* Disk description table, see disktab (5) * 
*/ 

#ifdef mips 

#include <sys/types.h> 
#include <mips/dvh.h> 
#endif 

#ifndef NPARTAB 
#define NUPART 8 
#else 
/* 

* Number of user partitions is the total number of partitions minus 

* the volume header, sector forwarding, and entire volume partitions. 
*/ 

#define NUPART (NPARTAB - 3) 
#endif 

#defineDISKTAB 7etc/disktab" 

struct disktab { 

char *d_name; /* drive name */ 

char *d_type; /* drive type */ 

int d_secsize; /* sector size in bytes */ 



int d__ntracks; /* # tracks/cylinder */ 

int d_nsectors; /* # sectors/tracl 

int d_ncylinders; /* # cylinders */ 



int d_nsectors; /* # sectors/track */ i 
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/* revolutions/minute */ 

/* supports DEC badl44 std */ 

/* use sect rather than cyl offsets */ 



}; 



int d_rpm; 

int d_badsectforw; 

int d^sectoffset; 

struct partition { 

int p_size; /* #sectors in partition */ 

short p_bsize; /* block size in bytes */ 

short p_fsize;/* frag size in bytes */ 

} d_partitions[NPARTAB]; 



struct disktab *getdiskbyname(); 

SEE ALSO 

disktab(5) 

ERRORS 

This information should be obtained from the system for locally available disks (in particular, 
the disk partition tables). 
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NAME i 

getenv, setenv, unsetenv - manipulate environmental variables 

SYNOPSIS 

char *getenv(name) 
char *name; 

setenv(name, value, overwrite) 
char *name, value; 
int overwrite; 

void unsetenv(name) 
char *name; 

DESCRIPTION 

getenv searches the environment list (see environ(l)) for a string of the form name^value and 
returns a pointer to the string value if such a string is present, and (NULL) if it is not. 

setenv searches the environment list as getenv does; if the string name is not found, a string of 
the form name—value is added to the environment. If it is found, and overwrite is non-zero, 
its value is changed to value, setenv returns on success and -1 on failure, where failure is 
caused by an inability to allocate space for the environment. 

unsetenv removes all occurrences of the string name from the environment. There is no 
library provision for completely removing the current environment. It is suggested that the fol- 
lowing code be used to do so. 

static char *envinit[l]; 

extern char **environ; 

environ = envinit; d^ 

All of these routines permit, but do not require, a trailing equals ("=") sign on name or a V. 

leading equals sign on value. 

SEE ALSO 

csh(l), sh(l), execve(2), environ(7) 
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NAME 

getenv - get value of environment variables 

SYNOPSIS 

subroutine getenv (ename, evalue) 
character*(*) ename, evaiue 

DESCRIPTION 

Getenv searches the environment list (see environ(l)) for a string of the form ename —value 
and returns value in evalue if such a string is present, otherwise fills evalue with blanks. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

environ(7), execve(2) 
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NAME f 

getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent - get file system descriptor file entry 

SYNOPSIS 

#include <fstab.h> 

struct fstab *getfsent() 

struct fstab *getfssp€c(spec) 

char *spec; . 

struct fstab *getf sfile (file) 
char *file; 

struct fstab *getfstype(type) 
char *type; 

int setfsentO 
int endfsentO 

DESCRIPTION 

getfsent, getfsspec, getfstype, and getfsfile each return a pointer to an object with the following 
structure containing the broken-out fields of a line in the file system description file, 
<fstab.h>. 

struct fstab { 

char *fs_spec; 

char *fs„file; 

char *fs_type; 

int fsjxeq; 

int fs_passno; | 

}; v 

The fields have meanings described in fstab (5). 

getfsent reads the next line of the file, opening the file if necessary. 

setfsent opens and rewinds the file. 

endfsent closes the file. 

getfsspec and getfsfile sequentially search from the beginning of the file until a matching special 
file name or file system file name is found, or until EOF is encountered, getfstype does like- 
wise, matching on the file system type field. 

FILES 

/etc/fstab 

SEE ALSO 

fstab(5) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 

ERRORS 

All information is contained in a static area so it must be copied if it is to be saved. 



( 
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NAME 

getgrent, getgrgid, getgrnam, setgrent, endgrent - get group file entry 

SYNOPSIS 

#include <grp.h> 

struct group *getgrent() 

struct group *getgrgid(gid) 
int gid; 

struct group *getgrnam(name) 
char *name; 

setgrent 
endgrentO 

DESCRIPTION 

getgrent, getgrgid and getgrnam each return pointers to an object with the following structure 
containing the broken-out fields of a line in the group file. 

/* */ 

/* | Copyright Unpublished, MIPS Computer Systems, Inc. All Rights | */ 
/* | Reserved. This software contains proprietary and confidential | */ 
/* | information of MIPS and its suppliers. Use, disclosure or | */ 
/* | reproduction is prohibited without the prior express written | */ 
/* | consent of MIPS. | */ 

/* */ 

/* $Header: grp.h,v 1.2 86/06/02 15:03:20 dee Exp $ */ 

/* grp.h 4.1 83/05/03 */ 

struct group { /* see getgrent(3) */ 
char *gr_name; 
char *gr_passwd; 
int gr_gid; 
char **gr_mem; 

}; 

struct group *getgrent(), *getgrgid(), *getgrnam(); 

The members of this structure are: 

gr_name The name of the group. 

gr_passwd The encrypted password of the group. 

gr_gid The numerical group-ID. 

gr_mem Null-terminated vector of pointers to the individual member 

names. 

getgrent simply reads the next line while getgrgid and getgrnam search until a matching gid or 
name is found (or until EOF is encountered). Each routine picks up where the others leave 
off so successive calls may be used to search the entire file. 

A call to setgrent has the effect of rewinding the group file to allow repeated searches. 
endgrent may be called to close the group file when processing is complete. 



FILES 



/etc/group 
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SEE ALSO 

getlogiu(3) r getpwent(3), group(5) 

DIAGNOSTICS 

A null pointer (0) is returned on EOF or error, 

ERRORS 

All information is contained in a static area so it must be copied if it is to be saved, 



( 
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NAME 

gethostbyname, gethostbyaddr, gethostent, sethostent, endhostent - get network host entry 

SYNOPSIS 

#include <netdb.h> 

extern int h_errno; 

struct hostent *gethostbyname(name) 
char *name; 

struct hostent *gethostbyaddr(addr, len, type) 
char *addr; int len, type; 

struct hostent *gethostent() 

sethostent (stayopen) 
int stayopen; 

endhostentO 

DESCRIPTION 

gethostbyname and gethostbyaddr each return a pointer to an object with the following struc- 
ture. This structure contains either the information obtained from the name server, 
named(8), or broken-out fields from a line in /etc/hosts. If the local name server is not run- 
ning these routines do a lookup in /etc/hosts. 

struct hostent { 

char *h_name; /* official name of host */ 

char **h_aliases; /* alias list */ 

int h_addrtype; /* host address type */ 

int h_length; /* length of address */ 

char **h_addr_iist; /* list of addresses from name server */ 

}; 

#defineh_addr h_addr_list[0] /* address, for backward compatibility */ 

The members of this structure are: 

huname Official name of the host. 

h_aliases A zero terminated array of alternate names for the host. 

h_addrtype The type of address being returned; currently always AFJNET. 

hjength The length, in bytes, of the address. 

h_addr_list A zero terminated array of network addresses for the host. Host 

addresses are returned in network byte order. 

h_addr The first address in h_addr_list; this is for backward compatiblity. 

sethostent allows a request for the use of a connected socket using TCP for queries. If the 
stayopen flag is non-zero, this sets the option to send all queries to the name server using TCP 
and to retain the connection after each call to gethostbyname or gethostbyaddr. 

endhostent closes the TCP connection. 

DIAGNOSTICS 

Error return status from gethostbyname and gethostbyaddr is indicated by return of a null 
pointer. The external integer hjerrno may then be checked to see whether this is a temporary 
failure or an invalid or unknown host. 

h_errno can have the following values: 

HOST_NOT_FOUND No such host is known. 
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TRY^AGAIN 

NOJLECOVERY 
NO^ADDRESS 



This is usually a temporary error and means that the local 
server did not receive a response from an authoritative server. 
A retry at some later time may succeed, 

This is a non-recoverable error. 

The requested name is valid but does not have an IP address; 
this is not a temporary error. This means another type of 
request to the name server will result in an answer. 



FILES 



/etc/hosts 



SEE ALSO 

hosts(5), resolver(3), named(8) 

CAVEAT 

gethomnt is defined, and sethostentmd endhostent are redefined, when Ubc is built to use only 
the routines to lookup in /etc/hosts 'and not the name server. 

gethostent reads the next line of /etc/hosts, opening the file if necessary. 

sethostent is redefined to open and rewind the file. If the stay open argument is non-zero, the 
hosts data base will not be closed after each call to gethostbyname or gethostbyaddr . endhos- 
tent is redefined to close the file, 



ERRORS 



All information is contained in a static area so it must be copied if it is to be saved. Only the 
Internet address format is currently understood. 



( 
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NAME 

getlog - get user's login name 

SYNOPSIS 

subroutine getlog (name) 
character* (*) name 

character* (*) function getlog 

DESCRIPTION 

Getlog will return the user's login name or all blanks if the process is running detached from a 
terminal. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

getlogin(3) 
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NAME 

getlogin - get login name 

SYNOPSIS 

char *getloginO 

DESCRIPTION 

getlogin returns a pointer to the login name as found in /etc/utmp. It may be used in conjunc- 
tion with getpwnarn to locate the correct password file entry when the same userid is shared by 
several login names. 

If getlogin is called within a process that is not attached to a terminal, or if there is no entry in 
/etc/utmp for the process's terminal, getlogin returns a NULL pointer (0). A reasonable pro- 
cedure for determining the login name is to first call getlogin and if it fails, to call 
getpwuid{getuidQ). 

FILES 

/etc/utmp 

SEE ALSO 

getpwent(3), utmp(5), ttyslot(3) 

DIAGNOSTICS 

Returns a NULL pointer (0) if name not found. 

ERRORS 

The return values point to static data whose content is overwritten by each call. 



( 



( 



( 
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NAME 

getmntent, setmntent, addmntent, endmntent, hasmntopt - get file system descriptor file entry 

SYNOPSIS 

#include <stdio.h> 
#include <mntent.h> 

FILE * setmntent (filep, type) 
char *filep; 
char *type; 

struct mntent *getmntent (filep) 
FILE *filep; 

int addmntent (filep, mnt) 

FILE *(ilep; 

struct mntent *mnt; 

char *hasmntopt(mnt, opt) 
struct mntent *mnt; 
char *opt; 

int endmntent(filep) 
FILE *filep; 

DESCRIPTION 

These routines replace the getfsent routines for accessing the file system description file 
/etc/ f stab . They are also used to access the mounted file system description file /etc/mtab . 

setmntent opens a file system description file and returns a file pointer which can then be used 
with getmntent, addmntent, or endmntent. The type argument is the same as in fopen (3). 
getmntent reads the next line from filep and returns a pointer to an object with the following 
structure containing the broken-out fields of a line in the filesystem description file, 
<mntent.h> , The fields have meanings described in fstab(5). 

/* file system name */ 
/* file system path prefix */ 
/* 4.2, nfs, swap, or xx */ 
/* ro, quota, etc. */ 
/* dump frequency, in days */ 
/* pass number on parallel fsck */ 

}; 

addmntent adds the mntent structure mnt to the end of the open file filep. Note that filep has 
to be opened for writing if this is to work, hasmntopt scans the mntjopts field of the mntent 
structure mnt for a substring that matches opt. It returns the address of the substring if a 
match is found, otherwise. Endmntent closes the file. 



struct mntent 


{ 


char 


*mnt_fsname 


char 


*mnt_dir; 


char 


*mnt_type; 


char 


*mnt_opts; 


int 


mntjxeq; 


int 


mnt_passno; 



FILES 



/etc/fstab 
/etc/mtab 



SEE ALSO 

fstab(5), getfsent(3) 
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DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 

ERRORS 

The returned mntent structure points to static information that is overwritten in each call. 



( 
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NAME 

getnetent, getnetbyaddr, getnetbyname, setnetent, endnetent - get network entry 

SYNOPSIS 

#include <netdb.h> 

struct netent *getnetent() 

struct netent *getnetbyname(name) 
char *name; 

struct netent *getnethyaddr(net, type) 
long net; 
int type; 

setnetent (stayopen) 
int stayopen; 

endnetentO 

DESCRIPTION 

getnetent, getnetbyname , and getnetbyaddr each return a pointer to an object with the follow- 
ing structure containing the broken-out fields of a line in the network data base, /etc/ networks. 

struct netent { 

char *n_name; /* official name of net */ 

char **n_aliases; /* alias list */ 

int n_addrtype; /* net number type */ 

unsigned long n_net; /* net number */ 

}; 

The members of this structure are: 

n_name The official name of the network. 

n_aliases A zero terminated list of alternate names for the network. 

n_addrtype The type of the network number returned; currently only 

AFJNET. 

n_.net The network number. Network numbers are returned in machine 

byte order. 

getnetent reads the next line of the file, opening the file if necessary. 

setnetent opens and rewinds the file. If the stayopen flag is non-zero , the net data base will not 
be closed after each call to getnetbyname or getnetbyaddr . 

Endnetent closes the file. 

getnetbyname and getnetbyaddr sequentially search from the beginning of the file until a match- 
ing net name or net address and type is found, or until EOF is encountered. Network 
numbers are supplied in host order. 

FILES 

/etc/networks 

SEE ALSO 

networks(5) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 
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ERRORS I 

All information is contained in a static area so it must be copied if it is to be saved. Only 
Internet network numbers are currently understood. Expecting network numbers to fit in no 
more than 32 bits is probably naive. 



( 
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NAME 

getnetgrent, setnetgrent, endnetgrent, innetgr - get network group entry 

SYNOPSIS 

innetgr(netgroup, machine, user, domain) 
char *netgroup, *machine, *user, *domain; 

setnetgrent(netgroup) 
char *netgroup 

endnetgrentO 

getnetgrent (machinep, userp, domainp) 
char **machinep, **userp, **domainp; 

DESCRIPTION 

inngetgr returns 1 or 0, depending on whether netgroup contains the machine, user, domain 
triple as a member. Any of the three strings machine, user, or domain can be NULL, in 
which case it signifies a wild card. 

getnetgrent returns the next member of a network group. After the call, machinep will contain 
a pointer to a string containing the name of the machine part of the network group member, 
and similarly for userp and domainp. If any of machinep, userp or domainp is returned as a 
NULL pointer, it signifies a wild card, getnetgrent will malloc space for the name. This space 
is released when a endnetgrent call is made, getnetgrent returns 1 if it succeeding in obtaining 
another member of the network group, if it has reached the end of the group. 

setnetgrent establishes the network group from which getnetgrent will obtain members, and also 
restarts calls to getnetgrent from the beginning of the list. If the previous setnetgrent call was 
to a different network group, a endnetgrent call is implied, endnetgrent frees the space allo- 
cated during the getnetgrent calls. 



FILES 



/etc/netgroup 
/etc/yp/domain/netgroup 
/etc/yp/domain/netgroup .byuser 
/etc/yp/domain/netgroup .byhost 
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NAME I 

getopt - get option letter from argv 

SYNOPSIS 

int getopt(argc 9 argv, optstring) 
int argc; 
char **argv; 
char *opt$tring; 

extern char *optarg; 
extern int optind; 

DESCRIPTION 

getopt returns the next option letter in argv that matches a letter in optstring, optstring is a 
string of recognized option letters; if a letter is followed by a colon, the option is expected to 
have an argument that may or may not be separated from it by white space, optarg is set to 
point to the start of the option argument on return from getopt. 

getopt places in optind the argv index of the next argument to be processed. Because optind is 
external, it is normally initialized to zero automatically before the first call to getopt. 

When all options have been processed (i.e,, up to the first non-option argument), getopt 
returns EOF. The special option — — may be used to delimit the end of the options; EOF will 
be returned, and — — will be skipped. 

DIAGNOSTICS 

getopt prints an error message on stderr and returns a question mark (?) when it encounters an 
option letter not included in optstring. 

EXAMPLE f 

The following code fragment shows how one might process the arguments for a command that ^ 

can take the mutually exclusive options a and b, and the options f and o, both of which 
require arguments: 

main(argc, argv) 
int argc; 
char **argv; 

{ 

int c; 

extern int optind; 

extern char *optarg; 



while ((c = getopt(argc, argv, "abf:o:")) !« EOF) 
switch (c) { 
case V: 

if (bflg) 

errflg4-+; 
else 

aflg++; 
break; 
case 'b ? : 

if (aflg) 

errflg++; 
else 

bprocQ; 
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break; 
case T : 

ifile = optarg; 

break; 
case 'o': 

ofile = optarg; 

break; 
case '?': 
default: 

errflg++; 

break; 

} 

if (errflg) { 

fprintf(stderr, "Usage: ..."); 
exit(2); 

} 

for (; optind < argc; optind++) { 



} 
HISTORY 

Written by Henry Spencer, working from a Bell Labs manual page. Modified by Keith Bostic 
to behave more like the System V version. 

ERRORS 

It is not obvious how '-' standing alone should be treated; this version treats it as a non- 
option argument, which is not always right. 

Option arguments are allowed to begin with '-'; this is reasonable but reduces the amount of 
error checking possible. 

getopt is quite flexible but the obvious price must be paid: there is much it could do that it 
doesn't, like checking mutually exclusive options, checking type of option arguments, etc. 



Page 2 February 5, 1989 MIPS Computer Systems, Inc. 



GETPASS ( 3-BSD ) RISC/os Programmer's Reference GETPASS ( 3-BSD ) 



NAME 

getpass - read a password 

SYNOPSIS 

char tgetpass (prompt) 
char *prompt; 

DESCRIPTION 

getpass reads a password from the file /devltty, or if that cannot be opened, from the standard 
input, after prompting with the null-terminated string prompt and disabling echoing. A 
pointer is returned to a null-terminated string of at most 8 characters. 

FILES 

Vdev/tty 

SEE ALSO 

crypt(3) 

ERRORS 

The return value points to static data whose content is overwritten by each call. 



( 



( 



3VHPS Computer Systems, Inc. February 5, 1989 Page 1 



GETPID ( 3F ) RISC/os Programmer's Reference GETPID ( 3F ) 



NAME 

getpid - get process id 

SYNOPSIS 

integer function getpid 

DESCRIPTION 

Getpid returns the process ID number of the current process. 

FILES ' 

/usr/lib/libU77.a 

SEE ALSO 

getpid(2) 
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NAME f 

getprotoent, getprotobynumber, getprotobyname, setprotoent, endprotoent - get protocol ^ 

entry 

SYNOPSIS 

#include <netdb.h> 

struct protoent *getprotoentO 

struct protoent *getprotobyname (name) 
char *name; 

struct protoent *getprotobynumber(proto) 
bit pioto; 

setprotoent(stayopen) 
int stay open 

endprotoent 

DESCRIPTION 

getprotoent , getprotobyname, and getprotobynumber each return a pointer to an object with 
the following structure containing the broken-out fields of a line in the network protocol data 
base, /etc/protocols. 

struct protoent { 

char *p„name; /* official name of protocol */ 

char **p_aliases; /* alias list */ 

int p_proto; /* protocol number */ 

}; 

The member? of this structure are: I 

pjtiame The official name of the protocol, 

p_aliases A zero terminated list of alternate names for the protocol. 

p_proto The protocol number. 

getprotoent reads the next line of the file, opening the file if necessary. 

setprotoent opens and rewinds the file. If the stayopen flag is non-zero, the net data base will 
not be closed after each call to getprotobyname or getprotobynumber . 

endprotoent closes the file. 

getprotobyname and getprotobynumber sequentially search from the beginning of the file until a 
matching protocol name or protocol number is found, or until EOF is encountered. 

FILES 

/etc/protocols 

SEE ALSO 

protocols(S) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 

ERRORS 

All information is contained in a static area so it must be copied if it is to be saved. Only the 
Internet protocols are currently understood. 



( 



MIPS Computer Systems, Inc. February 5, 1989 Page 1 



GETPW ( 3C-BSD ) RISC/os Programmer's Reference GETPW ( 3C-BSD ) 



NAME 

getpw - get name from uid 

SYNOPSIS 

getpw(uid, buf) 
char *buf; 

DESCRIPTION 

Getpw is made obsolete by getpwuid(3). 

getpw searches the password file for the (numerical) uid , and fills in buf with the correspond- 
ing line; it returns non-zero if uid could not be found. The line is null-terminated. 

FILES 

/etc/passwd 

SEE ALSO 

getpwent(3), passwd(5) 

DIAGNOSTICS 

Non-zero return on error. 
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NAME I 

getpwent, getpwuid, getpwnam, setpwent, endpwent, setpwfile - get password file entry 

SYNOPSIS 

#tnehide <pwd.h> 

struct passwd *getpwiiid(uid) 
int uid; 

struct passwd *getpwnam(name) 
char *name; 

struct passwd *getpwent() 

setpwent 

endpwent 

setpwfile (name) 
char *name; 

DESCRIPTION 

getpwent, getpwuid and getpwnam each return a pointer to an object with the following struc- 
ture containing the broken-out fields of a line in the password file. 

/* _ . — , :__ :_, */ 

I Copyright Unpublished, MIPS Computer Systems, Inc. All Rights | */ 
| Reserved. This software contains proprietary and confidential | */ 
j information of MIPS and its suppliers. Use, disclosure or | */ 
I reproduction is prohibited without the prior express written | */ 
I consent of MIPS. | */ 



/* 
/* 
/* 
/* 
/* 



/* $Header: pwd.h,v 1.2 86/06/02 15:04:37 dee Exp $ */ V 

/* pwd.h 4.1 83/05/03 */ 

struct passwd { /* see getpwent(3) */ 



char 


*pw_jname; 


char 


*pw_passwd; 


int 


pwjuid; 


int 


pw_gid; 


int 


pw_quota; 


char 


*pw_comment; 


char 


*pw_gecos; 


char 


*pw_dir; 


char 


♦pwjshell; 



}; 

struct passwd *getpwent(), *getpwuid(), *getpwnam(); 

The fields pw__quota and pwjzomment are unused; the others have meanings described in 
passwd (5). 

Searching of the password file is done using the ndhm database access routines, setpwent 
opens the database; endpwent closes it. getpwuid and getpwnam search the database (opening 
it if necessary) for a matching uid or name , EOF is returned if there is no entry. 

For programs wishing to read the entire database, getpwent reads the next line (opening the 
database if necessary). In addition to opening the database, setpwent can be used to make 
J getpwent begin its search from the beginning of the database. 
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setpwfile changes the default password file to name thus allowing alternate password files to be 
used. Note that it does not close the previous file. If this is desired, endpwent should be 
called prior to it. 

FILES 

/etc/passwd 

SEE ALSO 

getlogin(3), getgrent(3), passwd(5) 

DIAGNOSTICS 

The routines getpwent, getpwuid, and getpwnam, return a NULL pointer (0) on EOF or error. 

ERRORS 

All information is contained in a static area so it must be copied if it is to be saved. 
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NAME i 

getrpcent, getrpcbyname, getrpcbynumber - get RFC entry 

SYNOPSIS 

#inc!ude <netdb.h> 

struct rpcent *getrpcentQ 

struct rpcent *getrpcbyiiame(name) 
char *name; 

struct rpcent *getrpcbynumber(niimber) 
int number; 

setrpcent (stayopen) 
int stayopen 

endrpcentO 

DESCRIPTION 

getrpcent, getrpcbyname , and getrpcbynumber each return a pointer to an object with the fol- 
lowing structure containing the broken-out fields of a line in the rpc program number data 
base, /etc/rpc. 

struct rpcent { 

char *r_name; /* name of server for this rpc program */ 

char **r_aliases; /* alias list */ 

long renumber; /* rpc program number */ 

.}; 

The members of this structure are: 

rename The name of the server for this rpc program. ^ 

r_aliases A zero terminated list of alternate names for the rpc program. 

rjnumber The rpc program number for this service. 

getrpcent reads the next line of the file, opening the file if necessary. 

mtrpcent opens and rewinds the file. If the stayopen flag is non-zero, the net data base will not 
be closed after each call to getrpcent (either directly, or indirectly through one of the other 
"getrpc" calls). 

endrpcent closes the file, 

getrpcbyname and getrpcbynumber sequentially search from the beginning of the file until a 
matching rpc program name or program number is found, or until EOF is encountered. 

FILES 

/etc/rpc 

/etc/yp /domainname /rpc .bynumber 

SEE ALSO 

rpc(5), rpcinfo(8), ypservices(S) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 

ERRORS 

All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 

getrpcport - get RPC port number 

SYNOPSIS 

int getrpcport(host ? prognum, versnum, proto) 
char *host; 
int prognum, versnum, proto; 

DESCRIPTION 

getrpcport returns the port number for version versnum of the RPC program prognum running 
on host and using protocol proto. It returns if it cannot contact the portmapper, or if prog- 
num is not registered. If prognum is registered but not with version versnum, it will return that 
port number. 
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NAME 

gets, fgets - get a string from a stream 

SYNOPSIS 

#inclwde <stdio.h> 

char *gets(s) 
char *s; 

char *fget$.(s, n 9 stream) 
char *s; 
FILE *$tream; 

DESCRIPTION 

gets reads a string into s from the standard input stream stdin. The string is terminated by a 
newline character, which is replaced in s by a null character, gets returns its argument. 

fgets reads n-X characters, or up through a newline character/whichever comes first, from the 
stream into the string s. The last character read into $ is followed by a null character, fgets 
returns its first argument, 

SEE ALSO 

puts(3S), getc(3S), scanf(3S), fread(3S), ferror(3S) 
DIAGNOSTICS 

gets and fgets return the constant pointer NULL upon end of file or error. 
ERRORS 

gets deletes a newline, fgets keeps it, all in the name of backward compatibility. 



( 



( 
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NAME 

getservent, getservbyport, getservbyname, setservent, endservent - get service entry 

SYNOPSIS 

#include <netdb.h> 

struct servent *getservent() 

struct servent *getservbyname(name, proto) 
char *name, *proto; 

struct servent *getservbyport(port, proto) 
int port; char *proto; 

setservent (stay open) 
Int stayopen 

endserventO 

DESCRIPTION 

getservent, getservbyname, and getservbyport each return a pointer to an object with the follow- 
ing structure containing the broken-out fields of a line in the network services data base, 

/etc/ services. 

struct servent { 

char *s„name; /* official name of service */ 

char **s_aliases; /* alias list */ 

int s_port; /* port service resides at */ 

char *s_proto; /* protocol to use */ 

}; 

The members of this structure are: 

s„name The official name of the service. 

s_aliases A zero terminated list of alternate names for the service. 

s_port The port number at which the service resides. Port numbers are 

returned in network byte order. 

s_proto The name of the protocol to use when contacting the service, 

getservent reads the next line of the file, opening the file if necessary. 

setservent opens and rewinds the file. If the stayopen flag is non-zero, the net data base will 
not be closed after each call to getservbyname or .IR getservbyport . 

endservent closes the file. 

getservbyname and getservbyport sequentially search from the beginning of the file until a 
matching protocol name or port number is found, or until EOF is encountered. If a protocol 
name is also supplied (non-NULL), searches must also match the protocol. 



FILES 



/etc/services 



SEE ALSO 

getprotoent(3N), services(5) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 

ERRORS 

All information is contained in a static area so it must be copied if it is to be saved. Expect- 
ing port numbers to fit in a 32 bit quantity is probably naive. 
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NAME 

getttyent, getttynam, setttyent, endttyent - get ttys file entry 

SYNOPSIS 

#includc <ttyent.h> 

struct ttyent *getttyent() 

struct ttyent *getttpmm(iiame) 
char *narne; 

sctttyentO 
ewdtty^iitO 

DESCRIPTION 

getttyent, and getttynam each return a pointer to an object with the following structure contain- 
ing the broken-out fields of a line from the tty description file. 

/* __^_^ — m — „_ — _ — „„ ^ — __ — P */ 

/*■] Copyright Unpublished, MIPS Computer Systems, Inc. All Rights | */ 
/*' | Reserved. This software contains proprietary and confidential | */ 
/* j information of MIPS and its suppliers. Use, disclosure or | */ 
/* j reproduction is prohibited without the prior express written | */ 
/* j consent of MIPS. | */ 

; /# __,-^_.__„, ,_. — _ — : — r _ — */ 

/* $Header: ttyent.h,v 1.1 86/07/08 11:49:43 dee Exp $ */ 

struct ttyent { /* see getttyent(3) */ 

char *ty_name; /* terminal device name */ 

char *ty_getty; /* command to execute, usually getty */ 

char *ty_Jype; /* terminal type for termcap (3X) */ 

int ty^status; /* status flags (see below for defines) */ 

char *ty__window; /* command to start up window manager */ 

chai; *ty_comment; /* usually the location of the terminal */. 



( 



}; 



#define TTYJDN Qxl 

#deftne TTY3ECURE 0x2 

extern struct ttyent *getttyent(); 
extern struct ttyent *getttynam(); 



/* enable logins (startup getty) */ 
/* allow root to login */ 



tyj*ame is the name of the character-special file in the directory "/dev". For various 

reasons, it must reside in the directory a /dev". 

ty^getty is the command (usually getty (8)) which is invoked by init to initialize tty line 

characteristics. In fact, any arbitrary command can be used; a typical use is to 
initiate a terminal emulator in a window system. 

ty^type is the name of the default terminal type connected to this tty line. This is typi- 

cally a name from the termcap(S) data base. The environment variable 
TERM' is initialized with this name by getty (8) or login (1). 

tyjstatus is a mask of bit fields which indicate various actions to be allowed on this tty 

line. The following is a description of each flag. 

TTY-ON Enables logins (ie., init($) will start the specified "getty" 

command on this entry). 

TTYJSECURE Allows root to login on this terminal. Note that TJX.ONP 
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must be included for this to be useful. 

ty_windcw is the command to execute for a window system associated with the line. The 
window system will be started before the command specified in the ty_getty 
entry is executed. If none is specified, this will be null. 

ty_comment is the trailing comment field, if any; a leading delimiter and white space will be 
removed. 

getttyent reads the next line from the ttys file, opening the file if necessary; setttyent rewinds 
the file; endttyent closes it. 

getttynam searches from the beginning of the file until a matching name is found (or until EOF 
is encountered). 

FILES 

/etc/ttys 

SEE ALSO 

login(l), ttyslot(3), ttys(5), gettytab(5), termcap(5), getty(8), init(8) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 

ERRORS 

All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 

getusershell, setusershell, endusershell - get legal user shells 

SYNOPSIS 

char *getusershell() 

setusershell 
endusershell 

DESCRIPTION 

getusershell returns a pointer to a legal user shell as defined by the system manager in the file 
/etc/ shells . If /etc/ shells does not exist, the two standard system shells Ibinlsh and Ihinlcsh are 
returned. 

getusershell reads the next line (opening the file if necessary); setusershell rewinds the file; 
endusershell closes it. 

FILES 

/etc/shells 

DIAGNOSTICS 

The routine getusershell returns a null pointer (0) on EOF or error. 

ERRORS 

All information is contained in a static area so it must be copied if it is to be saved. 



( 



( 
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NAME 

getuid, getgid - get user or group ID of the caller 

SYNOPSIS 

integer function getuidO 

integer function getgid 

DESCRIPTION 

These functions return the real user or group ID of the user of the process. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

getuid(2) 
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NAME 

getwd - get current working directory pathname 

SYNOPSIS 

char *getwd (pathname) 
char ^pathname; 

DESCRIPTION 

getwd copies the absolute pathname of the current working directory to pathname and returns 
a pointer to the result. 

LIMITATIONS 

Maximum pathname length is MAXPATHLEN characters (1024), as defined in <$ys/param.h> . 

DIAGNOSTICS 

getwd returns zero and places a message in pathname if an error occurs. 



( 



( 
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NAME 

hypot, cabs - Euclidean distance, complex absolute value 

SYNOPSIS 

#include <math.h> 

double hypot (x,y) 
double x,y; 

float fhypot(float x, float y) 
double x,y; 

double cabs(z) 

struct {double x,y;} z; 

float fcabs(z) 
struct {float x,y;} z; 

DESCRIPTION 

Hypot(x,y), fhypot(x,y), cabs(x,y) and fcabs(x,y) return sqrt(x*x+y*y) computed in such a way 
that underflow will not happen, and overflow occurs only if the final result deserves it. 

Fhypot and fcabs are the same functions as hypot and cabs but for the float data type. 

hypot(oo,v) = hypot(v,oo) = +00 for all y, including NaN. 

DIAGNOSTICS 

When the correct value would overflow, hypot returns +00. 

ERROR (due to Roundoff, etc.) 

Below 0.97 ulps. Consequently hypot(5.0,12,0) == 13.0 exactly; in general, hypot and cabs 
return an integer whenever an integer might be expected. 

The same cannot be said for the shorter and faster version of hypot and cabs that is provided 
in the comments in cabs.c; its error can exceed 1.2 ulps. 

NOTES 

As might be expected, hypot(v, NaN) and hypot(A/flAf,v) are NaN for all finite v. Programmers 
might be surprised at first to discover that hypot(±oo ,NaN) = +00. This is intentional; it hap- 
pens because hypot(oo,v) = +00 for all v, finite or infinite. Hence hypot(oo,v) is independent 
of v. The IEEE NaN is designed to disappear when it turns out to be irrelevant, as it does in 
hypot(co, NaN). 

SEE ALSO 

math(3M), sqrt(3M) 

AUTHOR 

W. Kahan 
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NAME 

idate, itime - return date or time in numerical form 

SYNOPSIS 

subroutine id ate (iarray) 
integer iarray(3) 

subroutine itime (iarray) 
integer iarray(3) 

DESCRIPTION 

Idate returns the current date in iarray. The order is: day, mon, year. Month will be in the 
range 1-12. Year will be > 1969. 

Itime returns the current time in iarray. The order is: hour, minute, second. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

ctime(3F), fdate(3F) 



( 
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NAME 

copysign, drem, finite, logb, scalb - copysign, remainder, exponent manipulations 

SYNOPSIS 

#include <math.h> 

double copysign (x,y) 
double x,y; 

double drem(x,y) 
double x,y; 

int finite (x) 
double x; 

double logb(x) 
double x; 

double scalb (x,n) 
double x; 
int n; 

DESCRIPTION 

These functions are required for, or recommended by the IEEE standard 754 for 
floating-point arithmetic. 

Copysign(x,y) returns x with its sign changed to y's. 

Drem(x,y) returns the remainder r := x - n*y where n is the integer nearest the exact value of 
x/y; moreover if |n-x/y| = l/2 then n is even. Consequently the remainder is computed 
exactly and |r| < |y|/2. But drem(x,0) is exceptional; see below under DIAGNOSTICS. 

Finite(x) = 1 just when -oo < x < +00, 

= otherwise (when |x| = 00 or x is NaN) 

Logb(x) returns x's exponent n, a signed integer converted to double-precision floating-point 
and so chosen that 1 < |x|/2**n < 2 unless x = or |x| = 00 or x lies between and the 
Underflow Threshold. 

Scalb(x,n) = x*(2**n) computed, for integer n, without first computing 2**n. 

DIAGNOSTICS 

IEEE 754 defines drem(x,0) and drem(oo,y) to be invalid operations that produce a NaN. 

IEEE 754 defines logb(±oo) = +00 and logb(O) = -00, and requires the latter to signal 
Division-by-Zero . 

SEE ALSO 

floor(3M), fp_class(3), math(3M) 

AUTHOR 

Kwok-Choi Ng 



BUGS 



IEEE 754 currently specifies that logb(denormalized no.) = logb(tiniest normalized no. > 0) 
but the consensus has changed to the specification in the new proposed IEEE standard p854, 
namely that logb(x) satisfy 

1 < scalb( |x |,-logb(x)) < Radix . . . = 2 f or IEEE 754 
for every x except 0, 00 and NaN. Almost every program that assumes 754's specification will 
work correctly if logb follows 854' s specification instead. 

IEEE 754 requires copysign(x,AfaN) = ±x but says nothing else about the sign of a NaN. 
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NAME 

inet_addr, inet__network, inetjitoa, ineCmakeaddr, inetjnaof, inet_netof - Internet address 
manipulation routines 

SYNOPSIS 

#include <sys/socket.h> 
#include <netinet/kuh> 
#inelude <arpa/inet«h> 

unsigned long inet_addr(cp) 
char *cp; 

unsigned long inet_network(cp) 
char *cp; 

char *inet_ntoa(in) 
struct in_addr in; 

struct in_addr inet_makeaddr(net 9 Ina) 
int net, Ina; 

int inet_Jnaof(in) 
struct in_addr in; 

int inet„netof(in) 
struct in__addr in; 

DESCRIPTION 

The routines inet_addr and inetjietwork each interpret character strings representing numbers 
expressed in the Internet standard "." notation, returning numbers suitable for use as Internet 
addresses and Internet network numbers, respectively. The routine inetjntoa takes an Internet 
address and returns an ASCII string representing the address in "." notation. The routine 
inet_jnakeaddr takes an Internet network number and a local network address and constructs 
an Internet address from it. The routines inet_jietof and inetjnaof break apart Internet host 
addresses, returning the network number and local network address part, respectively. 

All Internet address are returned in network order (bytes ordered from left to right). All net- 
work numbers and local address parts are returned as machine format integer values. 

INTERNET ADDRESSES 

Values specified using the "." notation take one of the following forms: 

a.b.c.d 

a.b.c 

a.b 

a 
When four parts are specified, each is interpreted as a byte of data and assigned, from left to 
right, to the four bytes of an Internet address. Note that when an Internet address is viewed 
as a 32-bit integer quantity on the VAX the bytes referred to above appear as "d.c.b.a". That 
is, VAX bytes are ordered from right to left. 

When a three part address is specified, the last part is interpreted as a 16-bit quantity and 
placed in the right most two bytes of the network address. This makes the three part address 
format convenient for specifying Class B network addresses as "128.net.host". 

When a two part address is supplied, the last part is interpreted as a 24-bit quantity and placed 
in the right most three bytes of the network address. This makes the two part address format 
convenient for specifying Class A network addresses as "net. host". 

When only one part is given, the value is stored directly in the network address without any 

byte rearrangement. m 



MIPS Computer Systems, Inc. February 5, 1989 Page 1 



( 



INET ( 3N-BSD ) RISC/os Programmer's Reference INET ( 3N-BSD ) 



All numbers supplied as "parts" in a "." notation may be decimal, octal, or hexadecimal, as 
specified in the C language (i.e., a leading Ox or OX implies hexadecimal; otherwise, a leading 
implies octal; otherwise, the number is interpreted as decimal). 

SEE ALSO 

gethostbyname(3N), getnetent(3N), hosts(5), networks(5), 

DIAGNOSTICS 

The value -1 is returned by inetuaddr and inet_network for malformed requests. 

ERRORS 

The problem of host byte ordering versus network byte ordering is confusing. A simple way 
to specify Class C network addresses in a manner similar to that for Class B and Class A is 
needed. The string returned by inetjitoa resides in a static memory area. 
inetjaddr should return a struct injxddr. 

inetjnetof does not understand subnets, and will return the network number incorrectly in a 
subnetted environment. 
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NAME 

initgroups ~ initialize group access list 

SYNOPSIS 

initgroups (name, basegid) 
char *name; 
int basegid; 

DESCRIPTION 

initgroups reads through the group file and sets up, using the setgroups(2) call, the group 
access list for the user specified in name. The basegid is automatically included in the groups 
list. Typically this value is given as the group number from the password file. 

FILES 

/etc/group 

SEE ALSO 

setgroups(2) 

DIAGNOSTICS 

initgroups returns -1 if it was not invoked by the super-user. 

ERRORS 

initgroups uses the routines based on getgrent(3). If the invoking program uses any of these 
routines, the group structure will be overwritten in the call to initgroups. 



( 
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NAME 

insque, remque - insert/remove element from a queue 

SYNOPSIS 

struct qelem { 

struct qelem *q_forw; 
struct qelem *q_back; 
char q_data[]; 

>; 

insque(elem, pred) 
struct qelem *elem, *pred; 

remque (elem) 
struct qelem *elem; 

DESCRIPTION 

insque and remque manipulate queues built from doubly linked lists. Each element in the 
queue must in the form of "struct qelem' \ insque inserts elem in a queue immediately after 
pred; remque removes an entry elem from a queue. 

SEE ALSO 

"VAX Architecture Handbook", pp. 228-235. 
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NAME 



intro - introduction to C library functions 



DESCRIPTION 

This section describes functions that may be found in various libraries. The library functions 
are those other than the functions which directly invoke UNIX system primitives, described in 
section 2. Most of these functions are accessible from the C library, libc, which is automati- 
cally loaded by the C compiler (%(!), and the Pascal compiler pc(l). The link editor ld(l) 
searches this library under the Mc' option. The C library also includes all the functions 
described in section 2, 

A subset of these functions are available from Fortran; they are described separately in 
intro(W), 

The functions described in this section are grouped into various sections: 

(3) The straight * c 3 ?? functions are the standard C library functions. 

(3N) These functions constitute the internet network library. 

(3S) These functions constitute the 'standard I/O package', see stdio (3S) for more details. 
Declarations for these functions may be obtained from the include file <$tdio*h>. 

(3C) These routines are included for compatibility with other systems. In particular, a 
number of system call interfaces provided in previous releases of 4BSD have been 
included for source code compatibility. Use of these routines should, for the most 
part, be avoided. The manual page entry for each compatibility routine indicates the 
proper interface to use, 

(3M) These functions constitute the math library, libm . When functions in the math library 
(see math (3M)) are passed values that are undefined or would generate answers that 
are out of range, they return the values as defined by the IEEE 754-1985 standard for 
binary floating-point arithmetic. These are usually infinities or Nan's (not-a-number ? s). 
See the man page for the specific function and what it returns in these cases. The 
math library is loaded as needed by the Pascal compiler pc(l). C programs that wish 
to use this library need to specify the "-lm" option. 

(3X) These functions constitute minor libraries and other miscellaneous run-time facilities. 
Most are available only when programming in C. These functions include libraries 
that provide device independent plotting functions, terminal independent screen 
management routines for two dimensional non-bitmap display terminals, and functions 
for managing data bases with inverted indexes. These functions are located in 
separate libraries indicated in each manual entry. 

FILES 



/usr/lib/Jibc.a 


the C library 




/usr/lib/libm.a 


the math library 




SEE ALSO 






$tdio(3S) ? math(3M), intro(2), cc(l), ld(l), 


nm(l) 


LIST OF FUNCTIONS 






Name 


Appears on Page 


Description 


abort 


abort.3 


generate a fault 


abs 


abs,3 


integer absolute value 


: . acos . 


sin ,3m 


inverse trigonometric function 


acosh 


asinh3m 


inverse hyperbolic function 


alarm 


alarm .3c 


schedule signal after specified time 


alloca 


malloc,3 


memory allocator 


arc 


plot,3x 


graphics interface 
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asctime 


ctime.3 


convert date and time to ASCII 




asin 


sin. 3m 


inverse trigonometric function 




asinh 


asinh. 3m 


inverse hyperbolic function 




assert 


assert. 3x 


program verification 




atan 


sin. 3m 


inverse trigonometric function 




atanh 


asinh. 3m 


inverse hyperbolic function 




atan2 


sin. 3m 


inverse trigonometric function 




atof 


atof .3 


convert ASCII to numbers 




atoi 


atof.3 


convert ASCII to numbers 




atol 


atof.3 


convert ASCII to numbers 




bcmp 


bstring.3 


bit and byte string operations 




bcopy 


bstring.3 


bit and byte string operations 




bzero 


bstring.3 


bit and byte string operations 




cabs 


hypot.3m 


complex absolute value 




calloc 


malloc.3 


memory allocator 




cbrt 


sqrt.3m 


cube root 




ceil 


floor. 3m 


integer no less than 




circle 


plot.3x 


graphics interface 




clearerr 


ferror.3s 


stream status inquiries 




closedir 


directory.3 


directory operations 




closelog 


syslog.3 


control system log 




closepl 


plot.3x 


graphics interface 




cont 


plot.3x 


graphics interface 




copysign 


ieee.3m 


copy sign bit 




cos 


sin. 3m 


trigonometric function 




cosh 


sinh.3m 


hyperbolic function 




crypt 


crypt. 3 


DES encryption 




ctime 


ctime.3 


convert date and time to ASCII 




curses 


curses. 3x 


screen functions with "optimal" cursor 


motion 


dbminit 


dbm.3x 


data base subroutines 




delete 


dbm.3x 


data base subroutines 




drem 


ieee.3m 


remainder 




ecvt 


ecvt .3 


output conversion 




edata 


end. 3 


last locations in program 




encrypt 


crypt. 3 


DES encryption 




end 


end. 3 


last locations in program 




endfsent 


getfsent.3x 


get file system descriptor file entry 




endgrent 


getgrent.3 


get group file entry 




endhostent 


getho stbyname . 3n 


get network host entry 




endnetent 


getnetent.3n 


get network entry 




endprotoent 


getprotoent.3n 


get protocol entry 




endpwent 


getpwent.3 


get password file entry 




endservent 


getservent.3n 


get service entry 




environ 


execl. 3 


execute a file 




erase 


plot.3x 


graphics interface 




erf 


erf.3m 


error function 




erfc 


erf.3m 


complementary error function 




etext 


end. 3 


last locations in program 




exec 


execl. 3 


execute a file 




exece 


execl. 3 


execute a file 




execl 


execl. 3 


execute a file 




execle 


execl. 3 


execute a file 
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execlp 


execl,3 


execute a file 




exect 


execl.3 


execute a file 




execv 


execl.3 


execute a file 




execvp 


execl.3 


execute a file 




exit 


exit. 3 


terminate a process after flushing any pending 


output 


exp 


exp. 3m 


exponential 




expml 


exp. 3m 


exp(x)-l 




fabs 


floor.3m 


absolute value 




facos 


sin. 3m 


inverse trigonometric function 




fasin 


sin, 3m 


inverse trigonometric function 




fatan 


sin. 3m 


inverse trigonometric function 




fatan2 


sin. 3m 


inverse trigonometric function 




fcabs 


hypot.3m 


complex absolute value 




fceil 


floor.3m 


integer no less than 




f close 


fclose.3s 


close or flush a stream 




fcos 


sin. 3m 


trigonometric function 




fcvt 


ecvt.3 


output conversion 




feof 


ferror.3s 


stream status inquiries 




ferror 


ferror.3s 


stream status inquiries 




fetch 


dbm.3x 


data base subroutines 




fexp 


exp. 3m 


exponential 




fexpml 


exp. 3m 


exp(x)-l 




ffloor 


floor. 3m 


integer no greater than 




fflush 


fclose.3s 


close or flush a stream 




ffs 


bstring.3 


bit and byte string operations 




fgetc 


getc.3s 


get character or word from stream 




fgets 


gets. 3s 


get a string from a stream 




fhypot 


hypot.3m 


Euclidean distance 




fileno 


ferror.3s 


stream status inquiries 




finite 


ieee.3m 


is floating-point value finite 




firstkey 


dbm.3x 


data base subroutines 




flog 


exp. 3m 


natural logarithm 




floglp 


exp. 3m 


log(l+x) 




floor 


floor.3m 


integer no greater than 




fmod 


floor.3m 


floating-point remainder 




fopen 


fopen. 3s 


open a stream 




fprintf 


printf.3s 


formatted output conversion 




fputc 


putc.3s 


put character or word on a stream 




fputs 


puts. 3s 


put a string on a stream 




fread 


fread. 3s 


buffered binary input/output 




free 


malloc.3 


memory allocator 




frexp 


frexp. 3 


split into mantissa and exponent 




fscanf 


scanf.3s 


formatted input conversion 




fseek 


fseek .3s 


reposition a stream 




fsin 


sin. 3m 


trigonometric function 




fsinh 


sinh.3m 


hyperbolic function 




ftan 


sin. 3m 


trigonometric function 




ftanh 


sinh.3m 


hyperbolic function 




fsqrt 


sqrt.3m 


square root 




ftell 


fseek 3s 


reposition a stream 




ftime 


time. 3c 


get date and time 




ftrunc 


floor.3m 


floating-point truncation 
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fwrite 

gcvt 

getc 

getchar 

getdiskbyname 

getenv 

getfsent 

getfsfile 

getfsspec 

getfstype 

getgrent 

getgrgid 

getgrnam 

gethostbyaddr 

gethostbyname 

getho stent 

getlogin 

getnetbyaddr 

getnetbyname 

getnetent 

getpass 

getprotobyname 

getprotobynumber 

getprotoent 

getpw 

getpwent 

getpwnam 

getpwuid 

gets 

getservbyname 

getservbyport 

getservent 

getw 

getwd 

gmtime 

gtty 

htonl 

htons 

hypot 

index 

inet_addr 

inetjnaof 

inet_makeaddr 

inet_netof 

inet_network 

init groups 

initstate 

insque 

isalnum 

isalpha 

isascii 

isatty 



fread.3s 

ecvt.3 

getc. 3s 

getc. 3s 

getdisk.3x 

getenv. 3 

getfsent.3x 

getfsent.3x 

getfsent.3x 

getfsent.3x 

getgrent .3 

getgrent .3 

getgrent .3 

getho stbyname . 3n 

getho stbyname . 3n 

getho stbyname . 3n 

getlogin. 3 

getnetent. 3n 

getnetent. 3n 

getnetent. 3n 

getpass. 3 

getprotoent.3n 

getprotoent. 3n 

getprotoent. 3n 

getpw. 3 

getpwent. 3 

getpwent. 3 

getpwent. 3 

gets .3s 

getservent. 3n 

getservent.3n 

getservent. 3n 

getc. 3s 

getwd. 3 

ctime.3 

stty.3c 

byteorder.3n 

byteorder.3n 

hypot. 3m 

string.3 

inet.3n 

inet.3n 

inet.3n 

inet.3n 

inet.3n 

initgroups.3x 

random. 3 

insque. 3 

ctype.3 

ctype.3 

ctype.3 

ttyname.3 



buffered binary input/ output 

output conversion 

get character or word from stream 

get character or word from stream 

get disk description by its name 

value for environment name 

get file system descriptor file entry 

get file system descriptor file entry 

get file system descriptor file entry 

get file system descriptor file entry 

get group file entry 

get group file entry 

get group file entry 

get network host entry 

get network host entry 

get network host entry 

get login name 

get network entry 

get network entry 

get network entry 

read a password 

get protocol entry 

get protocol entry 

get protocol entry 

get name from uid 

get password file entry 

get password file entry 

get password file entry 

get a string from a stream 

get service entry 

get service entry 

get service entry 

get character or word from stream 

get current working directory pathname 

convert date and time to ASCII 

set and get terminal state (defunct) 

convert values between host and network byte order 

convert values between host and network byte order 

Euclidean distance 

string operations 

Internet address manipulation routines 

Internet address manipulation routines 

Internet address manipulation routines 

Internet address manipulation routines 

Internet address manipulation routines 

initialize group access list 

better random number generator 

insert/remove element from a queue 

character classification macros 

character classification macros 

character classification macros 

find name of a terminal 
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iscntrl 


ctype.3 


character classification macros 


isdigit 


ctype.3 


character classification macros 


islower 


ctype.3 


character classification macros 


isprint 


ctype.3 


character classification macros 


ispunct 


ctype.3 


character classification macros 


isspace 


ctype.3 


character classification macros 


isupper 


ctype.3 


character classification macros 


JO 


j0.3m 


bessel function 


jl 


j0.3m 


bessel function 


jn 


j0.3m 


bessel function 


label 


plot.3x 


graphics interface 


Idexp 


frexp.3 


split into mantissa and exponent 


lgamma 


lgamma. 3m 


log gamma function; (formerly gamma.3m) 


lib2648 


lib2643.3x 


subroutines for the HP 2648 graphics terminal 


line 


plot.3x 


graphics interface 


linemod 


plot.3x 


graphics interface 


localtime 


ctime.3 


convert date and time to ASCII 


log 


exp.3m 


natural logarithm 


logb 


ieee.3m 


exponent extraction 


loglO 


exp.3m 


logarithm to base 10 


loglp 


exp.3m 


log(l+x) 


longjmp 


setjmp.3 


non-local goto 


malloc 


malloc. 3 


memory allocator 


mktemp 


mktemp .3 


make a unique file name 


modf 


frexp.3 


split into mantissa and exponent 


moncontrol 


monitor.3 


prepare execution profile 


monitor 


monitor.3 


prepare execution profile 


monstartup 


monitor.3 


prepare execution profile 


move 


plot.3x 


graphics interface 


nextkey 


dbm.3x 


data base subroutines 


nice 


nice. 3c 


set program priority 


nlist 


nlist. 3 


get entries from name list 


ntohl 


byteorder.3n 


convert values between host and network byte order 


ntohs 


byteorder.3n 


convert values between host and network byte order 


opendir 


directory.3 


directory operations 


openlog 


syslog.3 


control system log 


openpl 


plot.3x 


graphics interface 


pause 


pause.3c 


stop until signal 


pclose 


popen.3 


initiate I/O to/from a process 


perror 


perror.3 


system error messages 


point 


plot.3x 


graphics interface 


popen 


popen. 3 


initiate I/O to/from a process 


pow 


exp.3m 


exponential x**y 


printf 


printf .3s 


formatted output conversion 


psignal 


psignal. 3 


system signal messages 


putc 


putc. 3s 


put character or word on a stream 


putchar 


putc. 3s 


put character or word on a stream 


puts 


puts.3s 


put a string on a stream 


putw 


putc. 3s 


put character or word on a stream 


qsort 


qsort. 3 


quicker sort 


rand 


rand. 3c 


random number generator 


random 


random. 3 


better random number generator 
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rcmd 


rcmd.3x 


routines for returning a stream to a remote command 


re_comp 


regex.3 


regular expression handler 


re_exec 


regex.3 


regular expression handler 


readdir 


directory.3 


directory operations 


realloc 


malloc.3 


memory allocator 


remque 


insque.3 


insert/remove element from a queue 


rewind 


f seek .3s 


reposition a stream 


rewinddir 


directory.3 


directory operations 


rexec 


rexec. 3x 


return stream to a remote command 


rindex 


string. 3 


string operations 


rint 


floor.3m 


round to nearest integer 


rresvport 


rcmd.3x 


routines for returning a stream to a remote command 


ruserok 


rcmd.3x 


routines for returning a stream to a remote command 


scalb 


ieee.3m 


exponent adjustment 


scandir 


scandir.3 


scan a directory 


scanf 


scanf .3s 


formatted input conversion 


seekdir 


directory.3 


directory operations 


setbuf 


setbuf .3s 


assign buffering to a stream 


setbuffer 


setbuf .3s 


assign buffering to a stream 


setegid 


setuid. 3 


set user and group ID 


seteuid 


setuid. 3 


set user and group ID 


setfsent 


getfsent.Sx 


get file system descriptor file entry 


setgid 


setuid. 3 


set user and group ID 


setgrent 


getgrent.3 


get group file entry 


sethostent 


gethostbyname.3n 


get network host entry 


setjmp 


setjmp. 3 


non-local goto 


setkey 


crypt. 3 


DES encryption 


setlinebuf 


setbuf .3s 


assign buffering to a stream 


setnetent 


getnetent.3n 


get network entry 


setprotoent 


getprotoent.3n 


get protocol entry 


setpwent 


getpwent.3 


get password file entry 


setrgid 


setuid. 3 


set user and group ID 


setruid 


setuid. 3 


set user and group ID 


setservent 


getservent.3n 


get service entry 


setstate 


random. 3 


better random number generator 


setuid 


setuid. 3 


set user and group ID 


signal 


signal .3 


simplified software signal facilities 


sin 


sin. 3m 


trigonometric function 


sinh 


sinh. 3m 


hyperbolic function 


sleep 


sleep. 3 


suspend execution for interval 


space 


plot.3x 


graphics interface 


sprintf 


printf.3s 


formatted output conversion 


sqrt 


sqrt .3m 


square root 


srand 


rand. 3c 


random number generator 


srandom 


random. 3 


better random number generator 


sscanf 


scanf .3s 


formatted input conversion 


stdio 


intro.3s 


standard buffered input/output package 


store 


dbm.3x 


data base subroutines 


strcat 


string. 3 


string operations 


strcmp 


string. 3 


string operations 


strcpy 


string. 3 


string operations 


strlen 


string. 3 


string operations 
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strncat 


string. 3 


strncmp 


string. 3 


strncpy 


string. 3 


stty 


stty .3c 


swab 


swab. 3 


sys_errlist 


perror.3 


sys_nerr 


perror.3 


sys_siglist 


psignal.3 


syslog 


syslog.3 


system 


system. 3 


tan 


sin. 3m 


tanh 


sinh.3m 


telldir 


directory.3 


tgetent 


termcap.3x 


tgetflag 


termcap.3x 


tgetnum 


termcap.3x 


tgetstr 


termcap.3x 


tgoto 


termcap.3x 


time 


time. 3c 


times 


times.3c 


timezone 


etime.3 


tputs 


termcap.3x 


trunc 


floor.3m 


ttyname 


ttyname. 3 


ttyslot 


ttyname. 3 


ungetc 


ungetc. 3s 


utime 


utime .3c 


valloc 


valloc. 3 


varargs 


varargs. 3 


vlimit 


vlimit.3c 


vtimes 


vtimes. 3c 


yO 


j0.3m 


yi 


j0.3m 


yn 


j0.3m 
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string operations 

string operations 

string operations 

set and get terminal state (defunct) 

swap bytes 

system error messages 

system error messages 

system signal messages 

control system log 

issue a shell command 

trigonometric function 

hyperbolic function 

directory operations 

terminal independent operation routines 

terminal independent operation routines 

terminal independent operation routines 

terminal independent operation routines 

terminal independent operation routines 

get date and time 

get process times 

convert date and time to ASCII 

terminal independent operation routines 

floating-point truncation 

find name of a terminal 

find name of a terminal 

push character back into input stream 

set file times 

aligned memory allocator 

variable argument list 

control maximum system resource consumption 

get information about resource utilization 

bessel function 

bessel function 

bessel function 
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NAME 



intro - introduction to RPC service library functions 



DESCRIPTION 

These functions constitute the RPC service library, librpcsvc. In order to get the link editor to 
load this library, use the —Irpcsvc option of cc. Declarations for these functions may be 
obtained from various include files <rpcsvc/*.h>. 



description 



IT OF FUNCTIONS 


routine 


on page 


ether 


ether(3R) 


getrpcport 


getrpcport(3R) 


havedisk 


rstat(3R) 


rex 


rex(3r) 


rnusers 


rnusers (3R) 


rquota 


rquota(3R) 


rstat 


rstat(3R) 


rusers 


rnusers (3R) 


rwall 


rwall(3R) 


spray 


spray(3R) 


yppasswd 


yppasswd (3R) 



monitor traffic on the Ethernet 

get RPC port number 

determine if remote machine has disk 

remote execution protocol 

return number of users on remote machine 

implement quotas on remote machines 

get performance data from remote kernel 

return information about users on remote machine 

write to specified remote machines 

scatter data in order to check the network 

update user password in yellow pages 
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NAME 



intro - introduction to FORTRAN library functions 



DESCRIPTION 

This section describes functions that are in the Fortran runtime library. 

The math intrinsics required by the 1977 Fortran standard are available, although not 
described here. In addition, the abs, sqrt, exp, log, sin, and cos intrinsics have been extended 
for double complex values. They can be referenced using the generic names listed above, or 
they can be referenced using their specific names that consist of the generic names preceded 
by either cd or z- For example, if zz is double complex, then sqrt(zz), zsqrt(zz), or cdsqrt(zz) 
compute the square root of zz* The dcmplx intrinsic forms a double complex value from two 
double precision variables or expressions, and the name of the specific function for the conju- 
gate of a double complex value is dconjg. 

Most of these functions are in libU77.a. Some are in libF77.a or libI77.a. 

For efficiency, the SCCS ID strings are not normally included in the a. out file. To include 
them, simply declare 

external f771id 



c 



in any f77 module. 

LIST OF FUNCTIONS 

Name Appears on Page 



Description 



abort abort.3f abnormal termination 

access access.3f determine accessibility of a file 

alarm alarm.3f execute a subroutine after a specified time 

chdir chdir.3f change default directory 

chmod chmod.3f change mode of a file 

ctime time.3f return system time 

dtime etime.3f return elapsed execution time 

etime etime.Sf return elapsed execution time 

fdate fdate.3f return date and time in an ASCII string 

fgetc getc.3f get a character from a logical unit 

flush flush. 3f flush output to a logical unit 

fork fork.3f create a copy of this process 

fputc putc.3f write a character to a fortran logical unit 

fseek fseek.3f reposition a file on a logical unit 

fstat stat.3f get file status 

f tell fseek.3f reposition a file on a logical unit 

gerror perror.3f get system error messages 

getarg getarg.3f return command line arguments 

getc getc.3f get a character from a logical unit 

getcwd getcwd.3f get pathname of current working directory 

getenv getenv.3f get value of environment variables 

getgid getuid.3f get user or group ID of the caller 

getlog getlog.3f get user's login name 

getpid getpid.3f get process id 

getuid getuid.3f get user or group ID of the caller 

gmtime time.3f return system time 

iargc getarg.3f return command line arguments 

idate idate.3f return date or time in numerical form 

ierrno perror.3f get system error messages 
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irand rand.3f return random values 

isatty ttynam.3f find name of a terminal port 

itime idate.3f return date or time in numerical form 

kill kill.3f send a signal to a process 

len len.3f tell about character objects 

link link.3f make a link to an existing file 

loc loc.3f return the address of an object 

ltime time.3f return system time 

perror perror.3f get system error messages 

putc putc.3f write a character to a fortran logical unit 

qsort qsort.3f quick sort 

rand rand.3f return random values 

signal signal.3f change the action for a signal 

sleep sleep. 3f suspend execution for an interval 

stat stat.3f get file status 

system system. 3f execute a UNIX command 

time time.3f return system time 

ttynam ttynam.3f find name of a terminal port 

unlink unlink. 3f remove a directory entry 

wait wait.3f wait for a process to terminate 
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NAME i 

jO, jl, jn, yO, yl, yn - bessel functions 

SYNOPSIS 

#include <math.h> 

double jO(x) 
double x; 

double jl(x) 
double x; 

double jn(n, x) 
int n; 
double x; 

double yO(x) 
double x; 

double yl(x) 
double x; 

double yn(n, x) 
int n; 
double x; 

DESCRIPTION 

JO and jl return Bessel functions of x of the first kind of orders and 1 respectively. Jn 
returns the Bessel function of x of the first kind of order n . 

YO and yl return Bessel functions of x of the second kind of orders and 1 respectively. Yn 
returns the Bessel function of x of the second kind of order n . The value of x must be posi- I 

tive. 

DIAGNOSTICS 

Non-positive arguments cause yO, yl and yn to return a quiet NaN. 

BUGS 

Arguments too large in magnitude cause jO, jl, yO and yl to return zero with no indication of 
the total loss of precision. 

SEE ALSO ' 

math(3M) 
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NAME 

kill - send a signal to a process 

SYNOPSIS 

function kill (pid, signum) 
integer pid, signum 

DESCRIPTION 

Fid must be the process id of one of the user's processes. Signum must be a valid signal 
number (see sigvec(2)). The returned value will be if successful; an error code otherwise. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

kill(2), sigvec(2) ? signal(3F), fork(3F), perror(3F) 
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NAME 

Idahread - read the archive header of a member of an archive file 

SYNOPSIS 

#include <stdio.h> 
#include <ar.h> 
#mclude <filehdr.h> 
#include <syms.h> 
#include <ldfcn.h> 

int Idahread 0dptr, arhead) 
LDFILE *ldptr; 
ARCHDR *arhead; 

DESCRIPTION 

If TYPEQdptr) is the archive file magic number, Idahread reads the archive header of the com- 
mon object file currently associated with Idptr into the area of memory beginning at arhead, 

Ldahread returns SUCCESS or FAILURE. If TYPE Qdptr) does not represent an archive file or 
if it cannot read the archive header, Ldahread fails. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ar(4),.ldfcn(4), and intro(4). 
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NAME 

ldclose, ldaclose - close a common object file 

SYNOPSIS 

#include <stdio.h> 
#incjude <filehdr.h> 
#include <syms.h> 
#include <ldfcn.h> 

int ldclose (ldptr) 
LDFILE *ldptr; 

int ldaclose (ldptr) 
LDFILE *ldptr; 

DESCRIPTION 

Ldopen(3X) and ldclose provide uniform access to simple object files and object files that are 
members of archive files. An archive of common object files can be processed as if it is a 
series of simple common object files. 

If TYPE (ldptr) does not represent an archive file, ldclose closes the file and frees the memory 
allocated to the LDFILE structure associated with ldptr. If TYPE (ldptr) is the magic number 
for an archive file and if archive has more files, ldclose reinitializes OFFSET(ldptr) to the file 
address of the next archive member and returns FAILURE. The LDFILE structure is prepared 
for a later ldopen(3X). In all other cases, ldclose returns SUCCESS. 

Ldaclose closes the file and frees the memory allocated to the LDFILE structure associated 
with ldptr regardless of the value of TYPE(ldptr). Ldaclose always returns SUCCESS. The 
function is often used with Idaopen . 
The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

fclose(3S), ldopen(3X), ldfcn(4). 
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NAME 

Idfhread - read the file header of a common object file 

SYNOPSIS 

#include <stdio.h> 
#mclude <filehdr.h> 
#in elude <syms.h> 
#include <ldfcn.h> 

int Idfliread (Idptr, filehead) 
LDFILE *ldptr; 
FILHDR *filehead; 

DESCRIPTION 

Ldfhread reads the file header of the common object file currently associated with Idptr . It 
reads the file header into the area of memory beginning at filehead. 

Ldfhread returns SUCCESS or FAILURE. If Idfhread cannot read the file header, it fails. 

Usually, Idfhread can be avoided by using the macro HEADER (Idptr) defined in <ldfcn.h> 
(see ldfcn(4)). Note that the information in HEADER is swapped, if necessary. The infor- 
mation in any field, fieldname, of the file header can be accessed using 
HEADER (Idptr) fieldname . 

The program must be loaded with the object file access routine library libmld.a. 
SEE ALSO 

ldclose(3X), ldopen(3X), ldfcn(4). 
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NAME 

ldgetaux - retrieve an auxiliary entry, given an index 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#include <sym.h> 
#include <ldfcn.h> 

pAUXU ldgetaux (ldptr, iaux) 
LDFDLE ldptr; 
long iaux; 

DESCRIPTION 

Ldgetaux returns a pointer to an auxiliary table entry associated with iaux. The AUXU is con- 
tained in a static buffer. Because the buffer can be overwritten by later calls to ldgetaux, it 
must be copied by the caller if the aux is to be saved or changed. 

Note that auxiliary entries are not swapped as this routine cannot detect what manifestation of 
the AUXU union is retrieved. If LDAUXSWAP(ldptr, Idf) is non-zero, a further call to 
swapjaux is required. Before calling the swap_aux routine, the caller should copy the aux. 

If the auxiliary cannot be retrieved, Ldgetaux returns NULL (defined in <stdio.h>) for an 
object file. This occurs when: 

• the auxiliary table cannot be found 

# the iaux offset into the auxiliary table is beyond the end of the table 

Typically, ldgetaux is called immediately after a successful call to Idtbread to retrieve the data 
type information associated with the symbol table entry filled by Idtbread. The index field of 
the symbol, pSYMR, is the iaux when data type information is required. If the data type infor- 
mation for a symbol is not present, the index field is indexNil and ldgetaux should not be 
called. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldtbseek(3X), ldtbread(3X), ldfen(4). 
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NAME I 

ldgetname - retrieve symbol name for object file symbol table entry 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#include <sym.h> 
#include <ldfcn.h> 

char *ldgetname (Idptr, symbol) 
LDFDLE * Idptr '; 
pSYMR * symbol ; 

DESCRIPTION 

Ldgetname returns a pointer to the name associated with symbol as a string. The string is con- 
tained in a static buffer. Because the buffer can be overwritten by later calls to ldgetname, the 
caller must copy the buffer if the name is to be saved. 

If the name cannot be retrieved, ldgetname returns NULL (defined in <stdio.h>) for an 
object file. This occurs when: 

• the string table cannot be found 

• the name's offset into the string table is beyond the end of the string table 

Typically, ldgetname is called immediately after a successful call to Idthread. Ldgetname 
retrieves the name associated with the symbol table entry filled by Idtbread. 

The program must be loaded with the object file access routine library libmld.a. I 

SEE ALSO 

ldclose(3X), ldopen(3X), ldtbseek(3X), ldtbread(3X), ldfcn(4). 



( 



MIPS Computer Systems, Inc. February 13, 1989 Page 1 



LDGETPD ( 3X ) RISC/os Programmer's Reference LDGETPD ( 3X ) 



NAME 

ldgetpd - retrieve procedure descriptor given a procedure descriptor index 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#include <sym.h> 
#include <ldfcn.h> 

long ldgetpd (ldptr, ipd, ppd) 
LDFILE ldptr; 
long ipd; 
pPDRipd; 

DESCRIPTION 

Ldgetpd returns a SUCCESS or FAILURE depending on whether the procedure descriptor 
with index ipd can be accessed. If it can be accessed, the structure pointed to by ppd is filled 
with the contents of the corresponding procedure descriptor. The isym, iline, and iopt fields 
of the procedure descriptor are updated to be used in further LD routine calls. The adr field is 
updated from the symbol referenced by the isym field. 

The PDR cannot be retrieved when: 

• The procedure descriptor table cannot be found. 

• The ipd offset into the procedure descriptor table is beyond the end of the table. 

• The file descriptor that the ipd offset falls into cannot be found. 

Typically, ldgetpd is called while traversing the table that runs from to 
SYMHE ADER(ldptr) .ipdMax - 1 . 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldtbseek(3X), ldtbread(3X), ldfcn(4). 
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NAME 

ldlread, Idlinit, Idlitem - manipulate line number entries of a common object file function 

SYNOPSIS 

#inelude <stdio.h> 
#iiiciude <filehdr.h> 
#include <syms.h> 
#include <ldfcn.h> 

int ldlread 0dptr, fcnindx, linenum, linent) 
LDFILE *ldptr; 
long fcnindx; 
unsigned short linenum; 

LINER linent; 

let Idlinit (Idptr, fcnindx) 
LDFILE *ldptr; 
long fcnindx; 

int Idlitem (Idptr, linenum, linent) 
LDFILE *ldptr; 
unsigned short linenum; 

LINER linent; 

DESCRIPTION 

Ldlread searches the line number entries of the common object file currently associated with 
Idptr. Ldlread begins its search with the line number entry for the beginning of a function and 
confines its search to the line numbers associated with a single function. The function is 
identified by fcnindx, which is the index of its local symbols entry in the object file symbol 
table. Ldlread reads the entry with the smallest line number equal to or greater than linenum 
into linent. 

Ldlinit and Idlitem together do exactly the same function as ldlread. After an initial call to 
ldlread or Idlinit, Idlitem can be used to retrieve a series of line number entries associated with 
a single function. Ldlinit simply finds the line number entries for the function identified by 
fcnindx. Ldlitem finds and reads the entry with the smallest line number equal to or greater 
than linenum into linent. 

Ldlread, Idlinit, and Idlitem each return either SUCCESS or FAILURE. If no line number 
entries exist in the object file, if fcnindx does not index a function entry in the symbol table, 
or if it finds no line number equal to or greater than linenum, ldlread fails. If no line number 
entries exist in the object file or if fcnindx does not index a function entry in the symbol table, 
Idlinit fails. If it finds no line number equal to or greater than linenum, Idlitem fails. 

The programs must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldtbindex(3X), ldfcn(4). 
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NAME 

ldlseek, Idnlseek - seek to line number entries of a section of a common object file 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#include <symSoh> 
#inchide <ldfcn.h> 

int Idlseek (ldptr, sectindx) 
LDFELE *ldptr; 
unsigned short sectindx; 

int Idnlseek (ldptr, sectname) 
LDFILE *ldptr; 
char *sectname; 

DESCRIPTION 

Ldlseek seeks to the line number entries of the section specified by sectindx of the common 
object file currently associated with ldptr. 

Ldnlseek seeks to the line number entries of the section specified by sectname. 

Ldlseek and Idnlseek return SUCCESS or FAILURE. NOTE: Line numbers are not associated 
with sections in the MIPS symbol table; therefore, the second argument is ignored, but main- 
tained for historical purposes. 

If they cannot seek to the specified line number entries, both routines fail. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldshread(3X), ldfcn(4). 
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NAME 

Idohseek - seek to the optional file header of a common object file 

SYNOPSIS 

#include <stdio.h> 
#include <filehdi\h> 
#include <$ym$.h> 
#include <ldfcn.h> 

int Idohseek (ldptr) 
LDFILE *ldptr; 

DESCRIPTION 

Ldohseek seeks to the optional file header of the common object file currently associated with 
ldptr. 

Ldohseek returns SUCCESS or FAILURE. If the object file has no optional header or if it can- 
not seek to the optional header, Idohseek fails. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X) ? ldfhread(3X), ldfcn(4). 
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NAME 

ldopen, ldaopen - open a common object file for reading 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <ldfcn.h> 

LDFILE *ldopen (filename, ldptr) 
char *filename; 
LDFILE *ldptr; 

LDFILE *ldaopen (filename, oldptr) 
char *filename; 
LDFILE *oldptr; 

Id readst (ldptr, flags) 
LDFILE *ldptr; 
intflags; 

DESCRIPTION 

Ldopen and ldclo$e(3X) provide uniform access to simple object files and to object files that 
are members of archive files. An archive of common object files can be processed as if it 
were a series of simple common object files. 

If ldptr has the value NULL, ldopen opens filename , allocates and initializes the LDFILE struc- 
ture, and returns a pointer to the structure to the calling program. 

If ldptr is valid and TYPE (Zdp/r) is the archive magic number, ldopen reinitializes the LDFILE 
structure for the next archive member of filename . 

Ldopen and Idclose work in concert. Ldclose returns FAILURE only when TYPE {ldptr) is the 
archive magic number and there is another file in the archive to be processed. Only then 
should ldopen be called with the current value of ldptr. In all other cases, and particularly 
when a new filename is opened, ldopen should be called with a NULL ldptr argument. 

The following is a prototype for the use of ldopen and ldclose: 

/* for each filename to be processed */ 

ldptr = NULL; 
do 

if ( (ldptr = ldopen(filename, ldptr)) != NULL ) 

{ 

/* check magic number */ 

/* process the file */ 

} 
} while (ldclose(ldptr) === FAILURE ); 

If the value of oldptr is not NULL, ldaopen opens filename anew and allocates and initializes a 
new LDFILE structure, copying the fields from oldptr. Ldaopen returns a pointer to the new 
LDFILE structure. This new pointer is independent of the old pointer, oldptr. The two 
pointers can be used concurrently to read separate parts of the object file. For example, one 
pointer can be used to step sequentially through the relocation information while the other is 
used to read indexed symbol table entries. 

Ldopen and ldaopen open filename for reading. If filename cannot be opened or if memory 
for the LDFILE structure cannot be allocated, both functions return NULL. A successful open 
does not ensure that the given file is a common object file or an archived object file. 
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Ldopen causes the symbol table header and file descriptor table to be read. Further access, I 

using Idptr, causes other, appropriate sections of the symbol table to be read (for example, if 
you call Idtbread, the symbols or externals are read). To force sections jot eh symbol table in 
memory, call Idreadst with STJ?* constants ORed together from stjsupport.h. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

fopen(3S), ldclose(3X), ldfcn(4). 
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NAME 

ldrseek, Idnrseek - seek to relocation entries of a section of a common object file 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#include <syms,h> 
#include <ldfcn.h> 

int ldrseek (ldptr, 'sectindx) 
LDFILE *ldptr; 
unsigned short sectindx; 

int Idnrseek (ldptr, sectname) 
LDFILE *ldptr; 
char *sectname; 

DESCRIPTION 

Ldrseek seeks to the relocation entries of the section specified by sectindx of the common 
object file currently associated with Idptr. 

Ldnrseek seeks to the relocation entries of the section specified by sectname . 

Ldrseek and Idnrseek return SUCCESS or FAILURE. If sectindx is greater than the number of 
sections in the object file, ldrseek fails; if there is no section name corresponding with 
sectname, Idnrseek fails. If the specified section has no relocation entries or if it cannot seek 
to the specified relocation entries, either function fails. 

NOTE: The first section has an index of one. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldshread(3X), ldfcn(4). 



MIPS Computer Systems, Inc. February 13, 1989 Page 1 



LDSHREAD ( 3X ) RISC/os Programmer's Reference LDSHREAD ( 3X ) 



NAME I 

Idshread, ldnshread - read an indexed/named section header of a common object file 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#include <scnhdrJi> 
#include <syms.h> 
#include <ldfcn,h> 

int Idshread (Idptr, sectindx, secthead) 
LDFILE *ldptr; 
unsigned short sectindx; 
SCNHDR *secthead; 

int ldnshread (ldptr ? sectname, secthead) 
LDFILE *ldptr; 
char *sectname; 
SCNHDR *secthead; 

DESCRIPTION 

Ldshread reads the section header specified by sectindx of the common object file currently 
associated with Idptr into the area of memory beginning at secthead. 

Ldnshread reads the section header specified by sectname into the area of memory beginning 
at secthead . 

Ldshread and ldnshread return SUCCESS or FAILURE. If sectindx is greater than the number 
of sections in the object file, Idshread fails; If there is no section name corresponding with 
sectname, ldnshread fails. If it cannot read the specified section header, either function fails. i 

NOTE: The first section header has an index oi one. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X) ? ldopen(3X) 3 ldfcn(4). 
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NAME 

ldsseek, ldnsseek - seek to an indexed/named section of a common object file 

SYNOPSIS 

#include <stdio.h> 
#inciude <filehdr.h> 
#include <syms.h> 
#include <ldfcn.h> 

int Idsseek 0dptr, sectindx) 
LDFILE *ldptr; 
unsigned short sectindx; 

int ldnsseek (ldptr, sectname) 
LDFILE *ldptr; 
char *sectname; 

DESCRIPTION 

Ldsseek seeks to the section specified by sectindx of the common object file currently associ- 
ated with ldptr. 

Ldnsseek seeks to the section specified by sectname . 

Ldsseek and ldnsseek return SUCCESS or FAILURE. If sectindx is greater than the number of 
sections in the object file, Idsseek fails; if there is no section name corresponding with 
sectname, ldnsseek fails. If there is no section' data for the specified section or if it cannot 
seek to the specified section, either function fails. 

NOTE: The first section has an index of one. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldshread(3X), ldfcn(4). 
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NAME 

Idtbread - read an indexed symbol table entry of a common object file 

SYNOPSIS 

#include <stdio.h> 
#Include <filehdr.h> 
#include <symsch> 
#ioclude <ldfcmh> 

int Idtbread (Idptr, symindex, symbol) 
LDFILE *ldptr; 
long symindex; 

pSYMR *symbol; 

DESCRIPTION 

Ldtbread reads the symbol table entry specified by symindex of the common object file 
currently associated with Idptr into the area of memory beginning at symbol. 

Ldtbread returns SUCCESS or FAILURE, If symindex is greater than the number of symbols in 
the object file or if it cannot read the specified symbol table entry, Idtbread fails. 

The local and external symbols are concatenated into a linear list. Symbols are accessible 
from symnum zero to $YMHEADER(ldptr).isymMax+SYMHEADER(ldptr).iextMax, The 
index and iss fields of the SYMR are made absolute (rather than file relative) so that routines 
ldgetname(3X),- ldgetaux(3X), and ldtbread (this routine) proceed normally given those 
indices. Only the "sym" part of externals is returned. 

NOTE: The first symbol in the symbol table has an index of zero. 

The program must be loaded with the object file access routine library libmld.a. 

SEE ALSO 

ldclose(3X), ldgetname(3X), ldopen(3X), ldtbseek(3X), ldgetname(3X) ? ldfcn(4). 
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NAME 

ldtbseek - seek to the symbol table of a common object file 

SYNOPSIS 

#include <stdioJi> 
#include <filehdr.h> 
#include <syms.h> 
#include <ldfcn.h> 

int ldtbseek (ldptr) 
LDFILE *ldptr; 

DESCRIPTION 

Ldtbseek seeks to the symbol table of the object file currently associated with ldptr. 

Ldtbseek returns SUCCESS or FAILURE. If the symbol table has been stripped from the 
object file or if it cannot seek to the symbol table, ldtbseek fails. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldtbread(3X), ldfcn(4). 
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NAME 

len - return length of Fortran string 

SYNOPSIS 

character*B ch 
integer i 
i = len(ch) 

DESCRIPTION 

len returns the length of string ch. 



c 
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NAME 

lgamma - log gamma function 

SYNOPSIS 

#include <math.h> 

double lgamma (x) 
double x; 

DESCRIPTION 

Lgamma returns In |r(x)| where T(x) = J™ t* -1 e -t dt f or x > and 

T(x) = 7r/(r(l-x) sin(7rx)) for x < 1. 

The external integer signgam returns the sign of T(x) . 

IDIOSYNCRASIES 

Do not use the expression signgam*exp(lgamma(x)) to compute g := T(x). Instead use a pro- 
gram like this (in C): 

lg = Igamma(x); g = signgam*exp(lg); 

Only after lgamma has returned can signgam be correct. Note too that r(x) must overflow 
when x is large enough, underflow when -x is large enough, and spawn a division by zero 
when x is a nonpositive integer. 

The following G program fragment might be used to calculate T if the overflow needs to. be 
detected: 

if ((y = lgamma(x)) > LN_MAXDOUBLE) 

errorQ; 

y= signgam * exp(y); 

where LNJVfAXDOUBLE is the least value that causes exp(3M) to overflow, and is defined in 
the <values.h> header file. 

Only in the UNIX math library for C was the name gamma ever attached to lnl\ Elsewhere, 
for instance in IBM's FORTRAN library, the name GAMMA belongs to r and the name 
ALGAMA to lnr in single precision; in double the names are DGAMMA and DLGAMA. 
Why should C be different? 

Archaeological records suggest that C's gamma originally delivered ln(r(|x|)). Later, the pro- 
gram gamma was changed to cope with negative arguments x in a more conventional way, but 
the documentation did not reflect that change correctly. The most recent change corrects 
inaccurate values when x is almost a negative integer, and lets T(x) be computed without con- 
ditional expressions. Programmers should not assume that lgamma has settled down. 

At some time in the future, the name gamma will be rehabilitated and used for the gamma 
function, just as is done in FORTRAN. The reason for this is not so much compatibility with 
FORTRAN as a desire to achieve greater speed for smaller values of |x| and greater accuracy 
for larger values. 

Meanwhile, programmers who have to use the name gamma in its former sense, for what is 
now lgamma, have two choices: 

1) Change your source to use lgamma instead of gamma. 

2) Add the following program to your others: 
#include <math,h> 

double gamma (x) 
double x; 

{ 

return (lgamma(x)); 

} 
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DIAGNOSTICS 

F returns -foo for negative integer arguments 

SEE ALSO 

math(3M) 
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NAME 

lib2648 - subroutines for the HP 2648 graphics terminal 

SYNOPSIS 

#include <stdio*h> 

typedef char *bitmat; 

FILE *trace; 

cc file.c -12648 

DESCRIPTION 

Ub2648 is a general purpose library of subroutines useful for interactive graphics on the 
Hewlett-Packard 2648 graphics terminal. To use it you must call the routine ttyinitQ at the 
beginning of execution, and doneQ at the end of execution. All terminal input and output 
must go through the routines rawchar, readline, outchar, and outstr. 

IW2648 does the necessary IB/! 7 handshaking if getenv("TERM") returns "hp2648", as it will 
if set by tset{l). Any other value, including for example "2648", will disable handshaking. 

Bit matrix routines are provided to model the graphics memory of the 2648. These routines 
are generally useful, but are specifically useful for the update function which efficiently 
changes what is on the screen to what is supposed to be on the screen. The primative bit 
matrix routines are newmat, mat, and setmat. 

The file trace, if non-null, is expected to be a file descriptor as returned by f open. If so, 
Ub2648 will trace the progress of the output by writing onto this file. It is provided to make 
debugging output feasible for graphics programs without messing up the screen or the escape 
sequences being sent. Typical use of trace will include: 
switch (argv[l][l]) { 
case T: 

trace = fopen("trace", "w"); 
break; 

if (trace) 

fprintf(trace, "x is %d, y is %s\n", x, y); 

dumpmat( M before update", xmat); 

ROUTINES 

agoto(x, y) 

Move the alphanumeric cursor to position (x, y), measured from the upper left corner 
of the screen. 

aoffO Turn the alphanumeric display off. 

aonO Turn the alphanumeric display on. 

areaclear(rmin 9 cmin, rmax, cmax) 

Clear the area on the graphics screen bordered by the four arguments. In normal 
mode the area is set to all black, in inverse video mode it is set to all white. 

beepO Ring the bell on the terminal. 

bitcopy(dest 9 src, rows, cols) bitmat dest 9 

Copy a rows by cols bit matrix from src to (user provided) dest. 

clearaO 

Clear the alphanumeric display. 

cleargO 
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Clear the graphics display. Note that the 2648 will only clear the part of the screen f 

that is visible if zoomed in. 

curoffO 

Turn the graphics cursor off. 

curonO 

Turn the graphics cursor on. 

dispmsg(str, x, y, maxlen) char *str; 

Display the message sir in graphics text at position (x, y). The maximum message 
length is given by maxlen , and is needed for dispmsg to know how big an area to clear 
before drawing the message. The lower left corner of the first character is at (x, y). 

doneO Should be called before the program exits. Restores the tty to normal, turns off 
graphics screen, turns on alphanumeric screen, flushes the standard output, etc. 

draw(x, y) 

Draw a line from the pen location to (x, y). As with all graphics coordinates, (x, y) is 
measured from the bottom left corner of the screen, (x, y) coordinates represent the 
first quadrant of the usual Cartesian system. 

drawbox(r, c, color, rows, cols) 

Draw a rectangular box on the graphics screen. The lower left corner is at. location (r, 
c). The box is rows rows high and cols columns wide. The box is drawn if color is 1, 
erased if color is 0. (r, c) absolute coordinates represent row and column on the 
screen, with the origin at the lower left. They are equivalent to (x, y) except for being 
reversed in order. 



dumpmat(msg, m, rows* cols) char *msg; bitmat m; 

If trace is non-null, write a readable ASCII representation of the matrix m on trace. 
Msg is a label to identify the output, 

emptyrow(m, rows* cols, r) bitmat m; 

Returns 1 if row r of matrix m is all zero, else returns 0. This routine is provided 
because it can be implemented more efficiently with a knowledge of the internal 
representation than a series of calls to mat. 

error(msg) char *msg; 

Default error handler. Calls message(msg) and returns. This is called by certain rou- 
tines in Ub2648. It is also suitable for calling by the user program. It is probably a 
good idea for a fancy graphics program to supply its own error procedure which uses 
$etjmp(3) to restart the program, 

gdefaultO 

Set the terminal to the default graphics modes. 

goffO Turn the graphics display off. 

gonQ Turn the graphics display on. 

koffO Turn the keypad off. 

konO Turn the keypad on. This means that most special keys on the terminal (such as the 
alphanumeric arrow keys) will transmit an escape sequence instead of doing their func- 
tion locally. 

line(xl, yl, x2, y2) 

Draw a line in the current mode from (xl, yl) to (x2, y2). This is equivalent to 
move(xl, yl); draw(x2, y2); except that a bug in the terminal involving repeated lines 
from the same point is compensated for. 
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lowleftQ 

Move the alphanumeric cursor to the lower left (home down) position. 

mat(m, rows, cols, r, c) bitmat m; 

Used to retrieve an element from a bit matrix. Returns 1 or as the value of the [r, 
c] element of the rows by cols matrix m. Bit matrices are numbered (r, c) from the 
upper left corner of the matrix, beginning at (0, 0). R represents the row, and c 
represents the column. 

message(str) char *str; 

Display the text message str at the bottom of the graphics screen. 

minmax(g, rows, cols, rmin, cmin, rmax, cmax) bitmat g; 
int *rmin, *cmin, *rmax, *cmax; 

Find the smallest rectangle that contains all the 1 (on) elements in the bit matrix g. 
The coordinates are returned in the variables pointed to by rmin, cmin, rmax, cmax. 

move(x, y) 

Move the pen to location (x, y), Such motion is internal and will not cause output 
until a subsequent sync(). 

movecurs(x, y) 

Move the graphics cursor to location (x, y). 

bitmat newmat(rows, cols) 

Create (with malloc(3)) a new bit matrix of size rows by cols. The value created (e.g. a 
pointer to the first location) is returned. A bit matrix can be freed directly with free, 

outchar(c) char c; 

Print the character c on the standard output. All output to the terminal should go 
through this routine or outstr. 

outstr(str) char *str; 

Print the string str on the standard output by repeated calls to outchar, 

printgO 

Print the graphics display on the printer. The printer must be configured as device 6 
(the default) on the HPIB. 

char rawcharO 

Read one character from the terminal and return it. This routine or readline should 
be used to get all input, rather than getchar(3), 

rboffQ Turn the rubber band line off. 

rbonO Turn the rubber band line on. 

char *rdchar(c) char c; 

Return a readable representation of the character c. If c is a printing character it 
returns itself, if a control character it is shown in the A X notation, if negative an apos- 
trophe is prepended. Space returns "\ rubout returns *?, 

NOTE; A pointer to a static place is returned. For this reason, it will not work to 
pass rdchar twice to the same fprintf I sprintf call. You must instead save one of the 
values in your own buffer with strcpy. 

readline (prompt, msg, maxlen) char *prompt, *msg; 

Display prompt on the bottom line of the graphics display and read one line of text 
from the user, terminated by a newline. The line is placed in the buffer msg, which 
has size maxlen characters. Backspace processing is supported. 

setclearQ 
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Set the display to draw lines in erase mode. (This is reversed by inverse video mode,) 
setmat(m, rows, cols, r, c, val) bitmat m; 

The basic operation to store a value in an element of a bit matrix. The [r, c] element 
of m is set to vol, which should be either or 1. 

setsetQ 

Set the display to draw lines in normal (solid) mode. (This is reversed by inverse 
video mode.) 

setxorQ 

Set the display to draw lines in exclusive or mode. 

syncO Force all accumulated output to be displayed on the screen. This should be followed 
by fflush(stdout). The cursor is not affected by this function. Note that it is normally 
never necessary to call sync, since rawchar and readline call syncQ and fflush(stdout) 
automatically. 

togvidO 

Toggle the state of video. If in normal mode, go into inverse video mode, and vice 
versa. The screen is reversed as well as the internal state of the library. 

ttyinitO 

Set up the terminal for processing. This routine should be called at the beginning of 
execution. It places the terminal in CBREAK mode, turns off echo, sets the proper 
modes in the terminal, and initializes the library. 

update (mold, mnew, rows, cols, baser, basec) bitmat mold, mnew; 

Make whatever changes are needed to make a window on the screen look like 'mnew. 
Mold is what the window on the screen currently looks like. The window has size 
rows by cols, and the lower left corner on the screen of the window is [baser, basec]. 
Note: update was not intended to be used for the entire screen. It would work but be 
very slow and take 64K bytes of memory just for mold and mnew. It was intended for 
100 by 100 windows with objects in the center of them, and is quite fast for such win- 
dows. 

vidinvO 

Set inverse video mode. 

vidnormO 

Set normal video mode. 

zermat(m, rows, cols) bitmat m; 

Set the bit matrix m to all zeros. 

zoomn(size) 

Set the hardware zoom to value size, which can range from 1 to 15. 

zoomoffO 

Turn zoom off. This forces the screen to zoom level 1 without affecting the current 
internal zoom number. 

zoomonQ 

Turn zoom on. This restores the screen to the previously specified zoom size. 

DIAGNOSTICS 

The routine error is called when an error is detected. The only error currently detected is 
overflow of the buffer provided to readline . 

Subscripts out of bounds to setmat return without setting anything. 
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FILES 

/usr/lib/lib2648.a 

SEE ALSO 

fed(l) 

AUTHOR 

Mark Horton 

ERROR 

This library is not supported. It makes no attempt to use all of the features of the terminal, 
only those needed by fed. Contributions from users will be accepted for addition to the 
library. 

The HP 2648 terminal is somewhat unreliable at speeds over 2400 baud, even with the *E/ F 
handshaking. In an effort to improve reliability, handshaking is done every 32 characters. 
(The manual claims it is only necessary every 80 characters.) Nonetheless, I/O errors some- 
times still occur. 

There is no way to control the amount of debugging output generated on trace without modify- 
ing the source to the library. 
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NAME 

VADS libraries - overview of VADS libraries 

DESCRIPTION 

VADS includes libraries containing packages and functions that may be referenced by user 
applications and a directory of examples using them, 

Libraries contained in the current release of the VADS are listed below. The exact contents 
varies with each implementation. 

standard - predefined Ada packages and additional packages to implement them 

verdixlib - Verdix-supplied packages 

publiclib* - public domain packages written in Ada . 

examples* - sample Ada program files 

*Note: publiclib and examples 

are neither supported nor warranted by VERDIX, 
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NAME 

link - make a link to an existing file 

SYNOPSIS 

function link (name!, name2) 
character* (*) name!, name 2 

integer function symlnk (namel, name2) 
character* (*) namel, name2 

DESCRIPTION 

Namel must be the pathname of an existing file, Name2 is a pathname to be linked to file 
namel. Name2 must not already exist. The returned value will be if successful; a system 
error code otherwise. 

Symlnk creates a symbolic link to namel. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

link(2), symlink(2), perror(3F), unlink(3F) 

BUGS 

Pathnames can be no longer than MAXPATHLEN as defined in <sys/param.h>. 
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NAME 

loc - return the address of an object 

SYNOPSIS 

function loc (arg) 

DESCRIPTION 

The returned value will be the address of arg. 

FILES 

/usr/lib/libU77,a 
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NAME 

lockf - advisory record locking on files 

SYNOPSIS 

#include <unistchh> 

#defineF„ULOCK /* Unlock a previously locked section */ 

#defineF_LOCK 1 /* Lock a section for exclusive use */ 

#defineF_TLOCK 2 /* Test and lock a section (non-blocking) */ 

#defineF_TEST 3 /* Test section for other process' locks */ 

lockf(fd 9 cmd, size) 
int fd, cmd; 
long size; 

DESCRIPTION 

lockf may be used to test, apply, or remove an advisory record lock on the file associated with 
the open descriptor fd. (See/cnf/(2) for more information about advisory record locking.) 

A lock is obtained by specifying a cmd parameter of F_LOCK or FJTLOCK. To unlock an 
existing lock, the FJJLOCK cmd is used. F_TEST is used to detect if a lock by another pro- 
cess is present on the specified segment. 

FJLOCK and FJTLOCK requests differ only by the action taken if the lock may not be immedi- 
ately granted, FJTLOCK will cause the function to return a -1 and set errno to EAGAIN if the 
section is already locked by another process. F_LOCK will cause the process to sleep until the 
lock may be granted or a signal is caught. 

size is the number of contiguous bytes to be locked or unlocked. The lock starts at the 
current file offset in the file and extends forward for a positive size or backward for a negative 
size (preceeding but not including the current offset). A segment need not be allocated to the 
file in order to be locked; however, a segment may not extend to a negative offset relative to 
the beginning of the file. If size is zero, the lock will extend from the current offset through 
the end-of-file. If such a lock starts at offset 0, then the entire file will be locked (regardless 
of future file extensions). 

NOTES 

The descriptor fd must have been opened with 0_WRONLY or CLRDWR permission in order 
to establish locks with this function call. 

All locks associated with a file for a given process are removed when the file is closed or the 
process terminates. Locks are not inherited by the child process in &fork(2) system call. 

RETURN VALUE 

Zero is returned on success, -1 on error, with an error code stored in errno. 

ERRORS 

lockf will fail if one or more of the following are true: 

EBADF fd is not a valid open descriptor. 

EBADF cmd is F_LOCK or FJTLOCK and the process does not have write 

permission on the file. 

EAGAIN cmd is FJTLOCK or F_TEST and the section is already locked by 

another process. 

EINTR cmd is FJLOCK and a signal interrupted the process while it was 

waiting for the lock to be granted. 

ENOLCK cmd is FJLOCK, FJTLOCK, or FJJLOCK and there are no more 

file lock entries available. 
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SEE ALSO I 

fcntl(2), lockd(8Q 

ERRORS 

File locks obtained through the lockf mechanism do not interact in any way with those 
acquired vmflock(2). They do, however, work correctly with the locks claimed by fcntl(2). 
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NAME 

malloc, free, realloc, calloc, alloca - memory allocator 

SYNOPSIS 

char *malloc(size) 
unsigned size; 

free(ptr) 
char *ptr; 

char *realloc(ptr, size) 
char *ptr; 
unsigned size; 

char *calloc(nelem, eisize) 
unsigned nelem, eisize; 

char *alloca(size) 
int size; 

DESCRIPTION 

malloc and free provide a general-purpose memory allocation package, malloc returns a 
pointer to a block of at least size bytes beginning on a word boundary. 

The argument to free is a pointer to a block previously allocated by malloc; this space is made 
available for further allocation, but its contents are left undisturbed, 

Needless to say, grave disorder will result if the space assigned by malloc is overrun or if some 
random number is handed to free . 

malloc maintains multiple lists of free blocks according to size, allocating space from the 
appropriate list. It calls sbrk (see brk{2)) to get more memory from the system when there is 
no suitable space already free. 

Realloc changes the size of the block pointed to by ptr to size bytes and returns a pointer to 
the (possibly moved) block. The contents will be unchanged up to the lesser of the new and 
old sizes. 

In order to be compatible with older versions, realloc also works if ptr points to a block freed 
since the last call of malloc, realloc or calloc; sequences of free, malloc and realloc were previ- 
ously used to attempt storage compaction. This procedure is no longer recommended, 

calloc allocates space for an array of nelem elements of size eisize. The space is initialized to 

zeros. 

alloca allocates size bytes of space in the stack frame of the caller. This temporary space is 

automatically freed on return. 

Each of the allocation routines returns a pointer to space suitably aligned (after possible 

pointer coercion) for storage of any type of object. If the space is of pagesize or larger, the 

memory returned will be page-aligi*ed. 

SEE ALSO 

brk(2), pagesize(2) 

DIAGNOSTICS 

malloc, realloc and calloc return a null pointer (0) if there is no available memory or if the 
arena has been detectably corrupted by storing outside the bounds of a block, malloc may be 
recompiled to check the arena very stringently on every transaction; those sites with a source 
code license may check the source code to see how this can be done. 
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ERRORS \ 

When realloc returns ? the block pointed to by ptr may be destroyed. 

The current implementation of malloc does not always fail gracefully when system memory 
limits are approached. It may fail to allocate memory when larger free blocks could be bro- 
ken up, or when limits are exceeded because the size is rounded up. It is optimized for sizes 

that are powers of two, 

alloca is machine dependent; its use is discouraged. 
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NAME 



math - introduction to mathematical library functions 



DESCRIPTION 

These functions constitute the C math library libra. There are two versions of the math library 
libm.a and Ubm43.a» 

The first, libm.a, contains routines written in MIPS assembly language and tuned for best per- 
formance and includes many routines for the float data type. The routines in there are based 
on the algorithms of Cody and Waite or those in the 4.3 BSD release, whichever provides the 
best performance with acceptable error bounds. Those routines with Cody and Waite imple- 
mentations are marked with a V in the list of functions below. 

The second version of the math library, Ubm43.a, contains routines all based on the original 
codes in the 4.3 BSD release. The difference between the two version's error bounds is typi- 
cally around 1 unit in the last place, whereas the performance difference may be a factor of 
two or more. 

The link editor searches this library under the "-1m" (or "-lm43") option. Declarations for 
these functions may be obtained from the include file <math.h>. The Fortran math library is 
described in "man 3f intro". 

LIST OF FUNCTIONS 

The cycle counts of all functions are approximate; cycle counts often depend on the value of 
argument. The error bound sometimes applies only to the primary range. 



Name 


Appears on Page 


acos 


sin. 3m 


aeosh 


asinh. 3m 


asin 


sin. 3m 


asinh 


asinh. 3m 


atan 


sin. 3m 


atanh 


asinh.3m 


atan2 


sin. 3m 


cabs 


hypot.3m 


cbrt 


sqrt.3m 


ceil 


floor.3m 


copysign 


ieee.3m 


cos* 


sin. 3m 


cosh* 


sinh.3m 


drem 


ieee.3m 


erf 


erf .3m 


erfc 


erf .3m 


exp* 


exp. 3m 


expml 


exp. 3m 


fabs 


floor.3m 


fatan* 


sin. 3m 


fcos* 


sin. 3m 


fcosh* 


sinh.3m 


fexp* 


exp. 3m 


flog* 


exp. 3m 


floor 


floor.3m 


fsin* 


sin. 3m 
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libm.a Ubm43.a libm.a Ubm43.a 



inverse trigonometric function 

inverse hyperbolic function 

inverse trigonometric function 

inverse hyperbolic function 

inverse trigonometric function 

inverse hyperbolic function 

inverse trigonometric function 

complex absolute value 

cube root 

integer no less than 

copy sign bit 

trigonometric function 

hyperbolic function 

remainder 

error function 

complementary error function 

exponential 

exp(x)~l 

absolute value 

inverse trigonometric function 

trigonometric function 

hyperbolic function 

exponential 

natural logarithm 

integer no greater than 

trigonometric function 
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fsinh* 


sinh. 3m 


fsqrt 


sqrt, 3m 


ftan* 


sin. 3m 


ftanh* 


sinh. 3m 


hypot 


hypot.3m 


jo 


j0.3m 


jl 


j0.3m 


jn 


j0.3m 


lgamma 


lgamma.3m 


log* 


exp.3m 


logb 


ieee,3m 


loglO* 


exp.3m 


loglp 


exp.3m 


pow 


exp.3m 


rint 


floor.3m 


scalb 


ieee.3m 


sin* 


sin. 3m 


sinh* 


sinh. 3m 


sqrt 


sqrt, 3m 


tan* 


sin, 3m 


tanh* 


sinh.3iii 


yO 


j0.3m 


yl 


j0.3m 


yn 


j0.3m 
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hyperbolic function 
square root 

trigonometric function 
hyperbolic function 
Euclidean distance 
bessel function 
bessel function 
bessel function 
log gamma function 
natural logarithm 
exponent extraction 
logarithm to base 10 
log(l+x) 
exponential x**y 
round to nearest integer 
exponent adjustment 
trigonometric function 
hyperbolic function 
square root 

trigonometric function 
hyperbolic function 
bessel function 
bessel function 
bessel function 
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NOTES 



In 4.3 BSD, distributed from the University of California in late 1985, most of the foregoing 
functions come in two versions, one for the double-precision "D" format in the DEC 
VAX- 11 family of computers, another for double-precision arithmetic conforming to the 
IEEE Standard 754 for Binary Floating-Point Arithmetic. The two versions behave very simi- 
larly, as should be expected from programs more accurate and robust than was the norm when 
UNIX was born. For instance, the programs are accurate to within the numbers of ulps tabu- 
lated above; an ulp is one Unit in the Last Race. And the programs have been cured of 
anomalies that afflicted the older math library libm in which incidents like the following had 
been reported: 

sqrt(-l.O) = 0.0 and log(-l.O) = -1.7e38, 

cos(l.Oe-ll) > cos(O.O) > 1.0. 

pow(x,1.0) ^ x when x = 2.0, 3.0, 4.0, ..., 9.0. 

pow(-1.0,1.0el0) trapped on Integer Overflow, 

sqrt(1.0e30) and sqrt(1.0e~30) were very slow. 
MIPS machines conform to the IEEE Standard 754 for Binary Floating-Point Arithmetic, to 
which only the notes for IEEE floating-point apply and are included here. 

IEEE STANDARD 754 Floating-Point Arithmetic: 

This stajidard is on its way to becoming more widely adopted than any other design for com- 
puter arithmetic. 

The main virtue of 4.3 BSD's libm codes is that they are intended for the public domain; they 
may be copied freely provided their provenance is always acknowledged, and provided users 
assist the authors in their researches by reporting experience with the codes. Therefore no 
user of UNIX on a machine that conforms to IEEE 754 need use anything worse than the new 
libm . 
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Properties of IEEE 754 Double-Precision: 

Wordsize: 64 bits, 8 bytes. Radix: Binary. 

Precision: 53 significant bits, roughly like 16 significant decimals. 

If x and x ? are consecutive positive Double-Precision numbers (they differ by 1 

ulp), then 

l.le-16 < 0.5**53 < (x'-x)/x < 0.5**52 < 2,3e-16. 

Range: Overflow threshold - 2.0**1024 - 1.8e308 
Underflow threshold = 0.5**1022 = 2.2e-308 
Overflow goes by default to a signed oo. 

Underflow is Gradual, rounding to the nearest integer multiple of 0.5**1074 = 
4.9e-324. 

Zero is represented ambiguously as +0 or -0. 

Its sign transforms correctly through multiplication or division, and is 
preserved by addition of zeros with like signs; but x~x yields +0 for every finite 
x. The only operations that reveal zero's sign are division by zero and 
copysign(x,±0). In particular, comparison (x > y, x > y, etc) cannot be 
affected by the sign of zero; but if finite x = y then oo = l/(x-y) ^ -l/(y-x) = 
-oo. 

oo is signed. 

it persists when added to itself or to any finite number. Its sign transforms 
correctly through multiplication and division, and (finite)/±oo = ±0 
(nonzero)/0 = ±oo. But oo-oo, oo*0 and oo/oo are, like 0/0 and sqrt(-3), 
invalid operations that produce NaN. ... 

Reserved operands: 

there are 2**53-2 of them, all called NaN {Not a Number). Some, called Sig- 
naling NaNs y trap any floating-point operation performed upon them; they 
could be used to mark missing or uninitialized values, or nonexistent elements 
of arrays. The rest are Quiet NaNs; they are the default results of Invalid 
Operations, and propagate through subsequent arithmetic operations. If x ^ x 
then x is NaN; every other predicate (x > y, x - y, x < y, ,,.) is FALSE if 
NaN is involved. 
NOTE: Trichotomy is violated by NaN. 

Besides being FALSE, predicates that entail ordered comparison, 
rather than mere (in)equality, signal Invalid Operation when NaN is 
involved. 

Rounding: 

Every algebraic operation (■+, -, *, /, V) is rounded by default to within half 
an ulp, and when the rounding error is exactly half an ulp then the rounded 
value's least significant bit is zero. This kind of rounding is usually the best 
kind, sometimes provably so; for instance, for every x = 1.0, 2.0, 3.0, 4.0, ..., 
2.0**52, we find (x/3.0)*3.0 == x and (x/10.0)*10.0 == x and ... despite that 
both the quotients and the products have been rounded. Only rounding like 
IEEE 754 can do that. But no single kind of rounding can be proved best for 
every circumstance, so IEEE 754 provides rounding towards zero or towards 
+oo or towards -oo at the programmer's option. And the same kinds of 
rounding are specified for Binary-Decimal Conversions, at least for magni- 
tudes between roughtly 1.0e-10 and 1.0e37. 
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Exceptions: 

IEEE 754 recognizes five kinds of floating-point exceptions, listed below in 
declining order of probable importance. 

Exception Default Result 



Invalid Operation NaN, or FALSE 

Overflow +00 

Divide by Zero ±00 

Underflow Gradual Underflow 

Inexact Rounded value 

NOTE: An Exception is not an Error unless handled badly. What makes a 
class of exceptions exceptional is that no single default response can be satis- 
factory in every instance. On the other hand, if a default response will serve 
most instances satisfactorily, the unsatisfactory instances cannot justify abort- 
ing computation every time the exception occurs. 

For each kind of floating-point exception, IEEE 754 provides a Flag that is raised 
each time its exception is signaled, and stays raised until the program resets it. Pro- 
grams may also test, save and restore a flag. Thus, IEEE 754 provides three ways by 
which programs may cope with exceptions for which the default result might be unsa- 
tisfactory: 

1) Test for a condition that might cause an exception later, and branch to avoid the 
exception. 

2) Test a flag to see whether an exception has occurred since the program last reset 
its flag. 

3) Test a result to see whether it is a value that only an exception could have pro- 
duced. 

CAUTION: The only reliable ways to discover whether Underflow has occurred 
are to test whether products or quotients lie closer to zero than the underflow 
threshold, or to test the Underflow flag. (Sums and differences cannot underflow 
in IEEE 754; if x ^ y then x-y is correct to full precision and certainly nonzero 
regardless of how tiny it may be.) Products and quotients that underflow gradually 
can lose accuracy gradually without vanishing, so comparing them with zero (as 
one might on a VAX) will not reveal the loss. Fortunately, if a gradually 
underflowed value is destined to be added to something bigger than the underflow 
threshold, as is almost always the case, digits lost to gradual underflow will not be 
missed because they would have been rounded off anyway. So gradual underflows 
are usually provably ignorable. The same cannot be said of underflows flushed to 

■0. 

At the option of an implementor conforming to IEEE 754, other ways to cope with 
exceptions may be provided: 

4) ABORT. This mechanism classifies an exception in advance as an incident to be 
handled by means traditionally associated with error-handling statements like 
"ON ERROR GO TO .„". Different languages offer different forms of this state- 
ment, but most share the following characteristics: 

- No means is provided to substitute a value for the offending operation's result and 
resume computation from what may be the middle of an expression. An excep- 
tional result is abandoned. 

- In a subprogram that lacks an error-handling statement, an exception causes the 
subprogram to abort within whatever program called it, and so on back up the 
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chain of calling subprograms until an error-handling statement is encountered or 
the whole task is aborted and memory is dumped. 

5) STOP. This mechanism, requiring an interactive debugging environment, is more 
for the programmer than the program. It classifies an exception in advance as a 
symptom of a programmer's error; the exception suspends execution as near as it 
can to the offending operation so that the programmer can look around to see 
how it happened. Quite often the first several exceptions turn out to be quite 
unexceptionable, so the programmer ought ideally to be able to resume execution 
after each one as if execution had not been stopped. 

6) ... Other ways lie beyond the scope of this document. 

The crucial problem for exception handling is the problem of Scope, and the problem's solu- 
tion is understood, but not enough manpower was available to implement it fully in time to be 
distributed in 4.3 BSD's libm. Ideally, each elementary function should act as if it were indi- 
visible, or atomic, in the sense that ... 

i) No exception should be signaled that is not deserved by the data supplied to that func- 
tion. 

ii) Any exception signaled should be identified with that function rather than with one of its 
subroutines. 

iii) The internal behavior of an atomic function should not be disrupted when a calling pro- 
gram changes from one to another of the five or so ways of handling exceptions listed 
above, although the definition of the function may be correlated intentionally with excep- 
tion handling. 

Ideally, every programmer should be able conveniently to turn a debugged subprogram into one 
that appears atomic to its users. But simulating all three characteristics of an atomic function 
is still a tedious affair, entailing hosts of tests and saves-restores; work is under way to 
ameliorate the inconvenience. 

Meanwhile, the functions in libm are only approximately atomic. They signal no inappropriate 
exception except possibly ... 
Over/Underflow 

when a result, if properly computed, might have lain barely within range, and 
Inexact in cabs, cbrt, hypot, loglO and pow 

when it happens to be exact, thanks to fortuitous cancellation of errors. 
Otherwise, ... 

Invalid Operation is signaled only when 

any result but NaN would probably be misleading. 
Overflow is signaled only when 

the exact result would be finite but beyond the overflow threshold. 
Divide-by-Zero is signaled only when 

a function takes exactly infinite values at finite operands. 
Underflow is signaled only when 

the exact result would be nonzero but tinier than the underflow threshold. 
Inexact is signaled only when 

greater range or precision would be needed to represent the exact result. 

Exceptions on MIPS machines: 

The exception enables and the flags that are raised when an exception occurs (as well 
as the rounding mode) are in the floating-point control and status register. This regis- 
ter can be read or written by the routines described on the man page fpc(3). This 
register's layout is described in the file <mips/fpu.h> in UMIPS-BSD releases and in 
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<sys/fpu.h > in UMIPS-SYSV releases. 

A full implementation of IEEE 754 "user trap handlers" is under development at 
MIPS computer systems. At which time all functions in libm will appear atomic and 
the full functionality of user trap handlers will be supported in theses language without 
other floating-point error handling intrinsics (i.e. ADA, Pl/1, etc). For a description 
of these trap handlers see section 8 of the IEEE 754 standard. 

What is currently available is only the raw interface which was only intended to be 
used by the code to implement IEEE user trap handlers. IEEE floating-point excep- 
tions are enabled by setting the enable bit for that exception in the floating-point con- 
trol and status register. If an exception then occurs the UNIX signal SIGFPE is sent 
to the process. It is up to the signal handler to determine the instruction that caused 
the exception and to take the action specified by the user. The instruction that caused 
the exception is in one of two places. If the floating-point board is used (the 
floating-point implementation revision register indicates this in it's implementation 
field) then the instruction that caused the exception is in the floating-point exception 
instruction register. In all other implementations the instruction that caused the 
exception is at the address of the program counter as modified by the branch delay bit 
in the cause register. Both the program counter and cause register are in the sigcon- 
text structure passed to the signal handler (see signal(3)). If the program is to be con- 
tinued past the instruction that caused the exception the program counter in the signal 
context must be advanced. If the instruction is in a branch delay slot then the branch 
must be emulated to determine if the branch is taken and then the resulting program 
counter can be calculated (see emulate Jbranck (3) and the NOTES (MIPS) section in 
signal '(3)). 



BUGS 



When signals are appropriate, they are emitted by certain operations within the codes, so a 
subroutine-trace may be needed to identify the function with its signal in case method 5) 
above is in use. And the codes all take the IEEE 754 defaults for granted; this means that a 
decision to trap all divisions by zero could disrupt a code that would otherwise get correct 
results despite division by zero. 

SEE ALSO 

fpc(3), signal(3), emulate_branch(3) 
R2010 Floating Point Coprocessor Architecture 
R2360 Floating Point Board Product Description 

An explanation of IEEE 754 and its proposed extension p854 was published in the IEEE 
magazine MICRO in August 1984 under the title "A Proposed Radix- and 
Word-length-independent Standard for Floating-point Arithmetic" by W. J. Cody et al. 
Articles in the IEEE magazine COMPUTER vol. 14 no. 3 (Mar. 1981), and in the ACM SIG- 
NUM Newsletter Special Issue of Oct. 1979, may be helpful although they pertain to super- 
seded drafts of the standard, 

AUTHOR 

W. -Kalian, with the help of Z-S. Alex Liu, Stuart I. McDonald, Dr. Kwok-Choi Ng, Peter 
Tang. 
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NAME 

memory: memccpy, memchr, memcmp, memcpy, memset - memory operations 

SYNOPSIS 

#include <memory,h> 

char *memccpy (sl,s2, c, n) char *sl, *s2; int c, n; 

char *memchr (s, c, n) char *s; int c, n; 

int memcmp (si, s2, n) char *sl, *s2; int n; 

char *memcpy (si, s2, n) char *sl, *s2; int n; 

char *memset (s, c 9 n) char *s; int c 9 n; 

DESCRIPTION 

These functions operates efficiently as possible on memory areas (arrays of characters 

bounded by a count, not terminated by a null character). They do not check for the overflow 

of any receiving memory area. 

memccpy copies characters from memory area s2 into si, stopping after the first occurrence of 

character c has been copied, or after n characters have been copied, whichever comes first. It 

returns a pointer to the character after the copy of c in si, or a NULL pointer if c was not 

found in the first n characters of s2. 

memchr returns a pointer to the first occurrence of character cin the first n characters of 

memory area s, or a NULL pointer if c does not occur. 

memcmp compares its arguments, looking at the first n characters only, and returns an integer 

less than, equal to, or greater than 0, according as si is lexicographically less than, equal to, 

or greater than s2. 

memcpy copies n characters from memory area s2 to si. It returns si. 

memset sets the first n characters in memory area s to the value of character c. It returns s. 

For user convenience, all these functions are declared in the optional <memory.h> header 

file. 

CAVEATS memcmp is implemented by using the most natural character comparison on the 
machine. Thus, the sign of the value returned when one of the characters has its high order 
bit set is not the same in all implementations and should not be relied upon. 

Character movement is performed differently in different implementations. Thus overlapping 
moves may yield surprises. 
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NAME 

mktemp - make a unique file name 

SYNOPSIS 

char *mktemp (template) 
char ^template; 

mkstemp (template) 
char ^template; 

DESCRIPTION 

mktemp creates a unique file name, typically in a temporary filesystem, by replacing template 
with a unique file name, and returns the address of the template. The template should con- 
tain a file name with six trailing X's, which are replaced with the current process id and a 
unique letter, mkstemp makes the same replacement to the template but returns a file descrip- 
tor for the template file open for reading and writing, mkstemp avoids the race between test- 
ing whether the file exists and opening it for use. 

SEE ALSO 

getpid(2), open (2) 

DIAGNOSTICS 

mkstemp returns an open file descriptor upon success. It returns -1 if no suitable file could be 
created. 
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NAME 

monitor, monstartup, moncontrol - prepare execution profile 

SYNOPSIS 

monitor(lowpc 9 highpc, buffer, bufsize, nfunc) 
int (*lowpc)0> (*highpc)0; 
short buffer □; 

monstartup (lowpc, highpc) 
int (*lowpc)0? (*highpc)0; 

moncontrol (mode) 

DESCRIPTION 

These functions use the profil(2) system call to control program-counter sampling. Using the 
option -p when compiling or linking a program (see The MIPS Languages Programmer Guide) 
automatically generates calls to these functions. You need not call them explicitly unless you 
want finer control. 

Typically, you would call either monitor or monstartup to initialize pc-sampling and enable it; 
call moncontrol to disable or reenable it; and call monitor again at the end of execution to dis- 
able sampling and record the samples in a file. 

Your initial call to monitor enables pc-sampling. Lowpc and highpc specify the range of 
addresses to be sampled; the lowest address is that of lowpc and the highest is just below 
highpc. buffer is the address of a (user allocated) array of bufsize short integers, which holds 
a record of the samples; for best results, the buffer should not be less than a few times smaller 
than the range of addresses sampled, nfunc is ignored. 

The environment variable PROFDIR determines the name of the output file and whether pc- 
sampling takes place: if it is not set, the file is named "mon.out"; if set to the empty string, no 
pc-sampling occurs; if set to a non-empty string, the file is named "string/pid.progname", 
where "pid" is the process id of the executing program and "progname" is the program's name 
as it appears in argv[0]. The subdirectory "string" must already exist. 

To profile the entire program, use: 

extern eprol(), etext(); 

monitor(eprol, etext, buf, bufsize, 0); 

eprol lies just below the user program text, and etext lies just above it, as described in end (3). 
(Because the user program does not necessarily start at a low memory address, using a small 
number in place of eprol is dangerous). 
monstartup is an alternate form of monitor that calls sbrk{2) for you to allocate the buffer. 

moncontrol selectively disables and re-enables pc-sampling within a program, allowing you to 
measure the cost of particular operations. moncontrol(O) disables pc-sampling, and moncon- 
trol(l) reenables it. 

To stop execution monitoring and write the results in the output file, use: 
monitor(O); 



MIPS Computer Systems, Inc. February 8, 1989 Page 1 



MONITOR ( 3-BSD ) RISC/os Programmer's Reference MONITOR ( 3-BSD ) 



FILES 

mon.out default name for output file 
libproflLa routines for pc-sampling 

SEE ALSO 

cc(l), prof(l), profil(2), sbrk(2) ? end(3), ld(l) and The MIPS hangup Programmer Guide. 
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NAME 

mount - keep track of remotely mounted filesystems 

SYNOPSIS 

#include <rpcsvc/mount.h> 

RPC INFO 

program number: 

MOUNTPROG 

xdr routines: 

xdr_exportbody(xdrs, ex) 

XDR *xdrs; 

struct exports *ex; 
xdr_exports(xdrs, ex); 

XDR *xdrs; 

stnict exports **ex; 
xdr_ihandle(xdrs, fh); 

XDR *xdrs; 

fhandle_t *fp; 
xdr_fhstatus(xdrs, fhs); 

XDR *xdrs; 

struct fhstatus *fhs; 
xdr_groups(xdrs, gr); 

XDR *xdrs; 

struct groups *gr; 
xdr_jnountbody(xdrs, ml) 

XDR *xdrs; 

struct mountlist *ml; 
xdr_jnountlist(xdrs, ml); 

XDR *xdrs; 

struct mountlist **ml; 
xdr_path(xdrs, path); 

XDR *xdrs; 

char **path; 

procs: 

MOUNTPROCJVTNT 

argument of xdr_path, returns fhstatus. 

Requires unix authentication. 
MOUNTPROCLDUMP 

no args, returns struct mountlist 
MOUNTPROCJJMNT 

argument of xdr_path, no results. 

requires unix authentication. 
MOUNTPROCJJMNTALL 

no arguments, no results. 

requires unix authentication. 

umounts all remote mounts of sender. 
MOUNTPROCJEXPORT 
MOUNTPROCJEXPORTALL 

no args, returns struct exports 

versions: 

MOUNTVERS_ORIG 
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structures: \^ 

struct mountlist { /* what is mounted */ 

char *mLname; 
char *mLpath; 
struct mountlist *mLnxt; 

}; 

struct fhstatus { 

int fhs„status; 
fhandle_t fhsjh; 

}; 

/* 

* List of exported directories 

* An export entry with ex__groups 

* NULL indicates an entry which is exported to the world. 
■ ■ */ 

struct exports { 

dev„t ex_dev; /* dev of directory */ 

char *ex_name; /* name of directory */ 

struct groups *ex_groups; /* groups allowed to mount this entry */ 

struct exports *ex.juext; 

}; 

struct groups { 

char *g__name; 

struct groups *g„next; 

>; ( 

SEE ALSO ^ 

mount(8), showmount(8) ? mountd(8C), 

NFS Protocol Spec, in Networking on the Sun Workstation. 



( 



Page 2 February 5, 1989 MIPS Computer Systems, Inc. 



MP ( 3X-BSD ) RISC/os Programmer's Reference MP ( 3X-BSD ) 



NAME 

madd, msub, mult, mdiv, pow, gcd, invert, rpow, msqrt, mcmp, move, min, omin, fmin, 
m_in, mout, omout, fmout, m_out, sdiv, itom - multiple precision integer arithmetic 

SYNOPSIS 

#include <mp.h> 
#incSude <stdio.h> 

typedef struct mint { int len; short *val; } MINT; 

madd (a, b, c) 

msub (a, b, c) 

mult (a, b, c) 

mdiv (a, b, q, r) 

pow(a, b, m, c) 

gcd(a, b, c) 

invert (a, b, c) 

rpow(a, n, c) 

msqrt(a, b, r) 

mcmp (a, b) 

move (a, b) 

min (a) 

omin (a) 

fmin (a, f) 

m_in(a, n 9 f) 

mout (a) 

omout(a) 

fmout (a 9 f) 

m_out(a, n, £) 

MINT *a, *b, *c, *m 5 *q, *r; 

FILE *f ; 

int n; 

sdiv(a, n, q, r) 
MINT *a, *q; 
short n; 
short *r; 

MINT *itom(n) 

DESCRIPTION 

These routines perform arithmetic on integers of arbitrary length. The integers are stored 
using the defined type MINT. Pointers to a MINT can be initialized using the function itom 
which sets the initial value to n. After that, space is managed automatically by the routines. 

madd, msub and mult assign to c the sum, difference and product, respectively, of a and b. 
mdiv assigns to q and r the quotient and remainder obtained from dividing a by b. sdiv is like 
mdiv except that the divisor is a short integer n and the remainder is placed in a short whose 
address is given as r. msqrt produces the integer square root of a in b and places the 
remainder in r. rpow calculates in c the value of a raised to the ("regular" integral) power n, 
while pow calculates this with a full multiple precision exponent b and the result is reduced 
modulo m . gcd returns the greatest common denominator of a and b in c , and invert com- 
putes c such that a*c mod 6-1, for a and b relatively prime, mcmp returns a negative, zero 
or positive integer value when a is less than, equal to or greater than b, respectively, move 
copies a to b . min and mout do decimal input and output while omin and omout do octal 
input and output. More generally, fmin and fmout do decimal input and output using file/, 
and mjn and m_out do I/O with arbitrary radix n . On input, records should have the form 
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of strings of digits terminated by a newline; output records have a similar form. I 

Programs which use the multiple-precision arithmetic library must be loaded using the loader 
flag -Imp. 

FILES 

/usr/include/mp.h include file 

/usr/lib/libmp.a object code library 

SEE ALSO 

dc(l), bc(l) 

DIAGNOSTICS 

Illegal operations and running out of memory produce messages and core images. 

ERRORS 

Bases for input and output should be <- 10. 

dc(l) and bc(l) don't use this library. 

The input and output routines are a crock. 

paw is also the mme of a standard math library routine. 
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NAME 

dbm_open, dbm_close, dbm_fetch, dbnustore, dbm_delete, dbmjirstkey, dbnunextkey, 
dbm_error, dbm_clearerr - data base subroutines 

SYNOPSIS 

#include <ndbm.h> 

typedef struct { 
char *dptr; 

int dsize; 
} datum; 

DBM *dbm__open(file, flags, mode) 
char *file; 
int flags, mode; 

void dbm__close(db) 
DBM *db; 

datum dbm_fetch(db, key) 
DBM *db; 
datum key; 

int dbm_store(db, key, content, flags) 
DBM *db; 

datum key, content; 
int flags; 

int dbm„delete(db, key) 
DBM *db; 
datum key; 

datum dfom_firstkey(db) 
DBM *db; 

datum dbm_nextkey(db) 
DBM *db; 

int dbm_error(db) 
DBM *db; 

int dbm_clearerr(db) 
DBM *db; 

DESCRIPTION 

These functions maintain key/content pairs in a data base. The functions will handle very 
large (a billion blocks) databases and will access a keyed item in one or two file system 
accesses. This package replaces the earlier dbm(3x) library, which managed only a single data- 
base. 

Keys and contents are described by the datum typedef, A datum specifies a string of dsize 
bytes pointed to by dptr. Arbitrary binary data, as well as normal ASCII strings, are allowed. 
The data base is stored in two files. One file is a directory containing a bit map and has '.dir ? 
as its suffix. The second file contains all data and has *.pag' as its suffix. 

Before a database can be accessed, it must be opened by dbmjopen . This will open and/or 
create the files file Mr and/?/e,pag depending on the flags parameter (see open (2)). 

Once open, the data stored under a key is accessed by dbmjetch and data is placed under a 
key by dbm^store. The flags field can be either DBM„INSERT or DBMJREPLACE, 
DBM_INSERT will only insert new entries into the database and will not change an existing 
entry with the same key. DBM_REPLACE will replace an existing entry if it has the same key. 
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A key (and its associated contents) is deleted by dbmjielete. A linear pass through all keys in \ 

a database may be made, in an (apparently) random order, by use of dbmjirstkey and 
dbmjiextkey. dbmjirstkey will return the first key in the database, dbm__nextkey will return 
the next key in the database. This code will traverse the data base: 

for (key = dbmjirstkey(db); key.dptr !- NULL; key = dbm__nextkey(db)) 

dbm__error returns non-zero when an error has occurred reading or writing the database. 
dbm__clearerr resets the error condition on the named database. 

DIAGNOSTICS 

All functions that return an int indicate errors with negative values. A zero return indicates 
ok. Routines that return a datum indicate errors with a null (0) dptr. If dbm_jtore called with 
& flags value of DBMLJNSERT finds an existing entry with the same key it returns 1. 
ERRORS 

The '.pag ? file will contain holes so that its apparent size is about four times its actual content. 
Older UNIX systems may create real file blocks for these holes when touched. These files can- 
not be copied by normal means (cp, cat, tp, tar, ar) without filling in the holes. 

dptr pointers returned by these subroutines point into static storage that is changed by subse- 
quent calls. 

The sum of the sizes of a key/content pair must not exceed the internal block size (currently 
4096 bytes). Moreover all key/content pairs that hash together must fit on a single block. 
dbmjstore will return an error in the event that a disk block fills with inseparable data. 
dbm__delete does not physically reclaim file space, although it does make it available for reuse. 

The order of keys presented by dbmjirstkey and dbmjiextkey depends on a hashing function, ^ 

not on anything interesting. | 

SEE ALSO 

dbm(3X) 



( 
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NAME 

nice - set program priority 

SYNOPSIS 

nice(incr) 

DESCRIPTION 

This interface is obsoleted by setpriority(2). 

The -scheduling priority of the process is augmented by incr. Positive priorities get less service 
than normal. Priority 10 is recommended to users who wish to execute long-running programs 
without flak from the administration. 

Negative increments are ignored except on behalf of the super-user. The priority is limited to 
the range -20 (most urgent) to 20 (least). 

The priority of a process is passed to a child process by fork (2). For a privileged process to 
return to normal priority from an unknown state, nice should be called successively with argu- 
ments -40 (goes to priority -20 because of truncation), 20 (to get to 0), then (to maintain 
compatibility with previous versions of this call). 

SEE ALSO 

nice(l), setpriority(2), fork (2), renice(8) 
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NAME 

nlist - get entries from name list 

SYNOPSIS 

#include <nlist.h> 

nlist (filename , nl) 
char ^filename; 
struct nlist nlQ; 

cc ... -lmld 

DESCRIPTION 

NOTE; The nlist subroutine has moved from the standard C library to the "mid" library due to 
the difference in the object file format. Programs that need to use nlist must be linked with 
the —lmld option. 

Nlist examines the name list in the given executable output file and selectively extracts a list of 
values. The name list consists of an array of structures containing names, types and values. 
The list is terminated with a null name. Each name is looked up in the name list of the file. 
If the name is found, the type and value of the name are inserted in the next two fields. If the 
name is not found, both entries are set to 0. For the structure declaration, see 
/usr/ include /nlist. h . 

This subroutine is useful for examining the system name list kept in the file /vmunix. In this 
way programs can obtain system addresses that are up to date. 

SEE ALSO 

a,out(5) 

DIAGNOSTICS £ 

If the file cannot be found or if it is not a valid namelist -1 is returned; otherwise, the number V 

of unfound namelist entries is returned. 

The type entry is set to if the symbol is not found. 



( 
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NAME 

ns_addr, ns_ntoa - Xerox NS(tm) address conversion routines 

SYNOPSIS 

#include <sys/types*h> 
#include <netns/ns.h> 

struct ns_addr ns_addr(cp) 
char *cp; 

char *ns_ntoa(ns) 
struct ns_addr ns; 

DESCRIPTION 

The routine nsjaddr interprets character strings representing XNS addresses, returning binary 
information suitable for use in system calls, nsjntoa takes XNS addresses and returns ASCII 
strings representing the address in a notation in common use in the Xerox Development 
Environment: 

<network number>.<host number>.<port number> 
Trailing zero fields are suppressed, and each number is printed in hexadecimal, in a format 
suitable for input to ns_addr . Any fields lacking super-decimal digits will have a trailing "H" 
appended. 

Unfortunately, no universal standard exists for representing XNS addresses. An effort has 
been made to insure that ns_addr be. compatible with most formats in common use. It will 
first separate an address into 1 to 3 fields using a single delimiter chosen from period (".")> 
colon (":") or pound-sign ( u # ?? ). Each field is then examined for byte separators (colon or 
period). If there are byte separators, each subfield separated is taken to be a small hexade- 
cimal number, and the entirety is taken as a network-byte-ordered quantity to be zero 
extended in the high-network-order bytes. Next, the field is inspected for hyphens, in which 
case the field is assumed to be a number in decimal notation with hyphens separating the mil- 
lenia. Next, the field is assumed to be a number: It is interpreted as hexadecimal if there is a 
leading "Ox" (as in C), a trailing "H" (as in Mesa), or there are any super-decimal digits 
present. It is interpreted as octal is there is a leading "0" and there are no super-octal digits. 
Otherwise, it is converted as a decimal number. 

SEE ALSO 

hosts(5), networks(5), 

DIAGNOSTICS 

None (see ERRORS). 

ERRORS 

The string returned by nsjitoa resides in a static memory area. 

nsjxddr should diagnose improperly formed input, and there should be an unambiguous way 

to recognize this. 
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NAME ^ 

pause - stop until signal 

SYNOPSIS 

pause 

DESCRIPTION 

pause never returns normally. It is used to give up control while waiting for a signal from 
kill (2) or an interval timer, see setitimer(2). Upon termination of a signal handler started dur- 
ing a pause, the pause call will return. 

RETURN VALUE 

Always returns -1. 

ERRORS 

pause always returns: 

[EINTR] The call was interrupted. 

SEE ALSO 

kill(2), select(2), sigpause(2) 



( 



( 
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NAME 

perror, sys_errlist, sys_jierr - system error messages 

SYNOPSIS 

perror(s) 
char *s; 

int sys_nerr; 
char *sys_errlist[]; 

DESCRIPTION 

perror produces a short error message on the standard error file describing the last error 
encountered during a call to the system from a C program. First the argument string s is 
printed, then a colon, then the message and a new-line. Most usefully, the argument string is 
the name of the program which incurred the error. The error number is taken from the exter- 
nal variable errno (see intra (2)), which is set when errors occur but not cleared when non- 
erroneous calls are made. 

To simplify variant formatting of messages, the vector of message strings sysjzrrlist is pro- 
vided; errno can be used as an index in this table to get the message string without the new- 
line, sysjterr is the number of messages provided for in the table; it should be checked 
because new error codes may be added to the system before they are added to the table. 

SEE ALSO 

intro(2), psignal(3) 
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NAME 

perror, gerror, ierrno - get system error messages 

SYNOPSIS 

subroutine perror (string) 
character* (*) string 

subroutine gerror (string) 
character* (*) string 

character* (*) function gerror 

function ierrno 

DESCRIPTION 

Perror will write a message to fortran logical unit appropriate to the last detected system 
error. String will be written preceding the standard error message, 

Gerror returns the system error message in character variable string. Gerror may be called 
either as a subroutine or as a function. 

Ierrno will return the error number of the last detected system error. This number is updated 
only when an error actually occurs. Most routines and I/O statements that might generate 
such errors return an error code after the call; that value is a more reliable indicator of what 
caused the error condition. 



( 



FILES 



/usr/lib/libU77.a 



SEE ALSO I 

intro(2), perror (3) ^ 

D. L. Wasley, Introduction to the f77 I/O Library 

BUGS 

String in the call to perror can be no longer than 127 characters. 

The length of the string returned by gerror is determined by the calling program. 

NOTES 

UNIX system error codes are described in intro{2). The f 77 I/O error codes and their mean- 
ings are: 

100 "error in format" 

101 "illegal unit number" 

102 "formatted i/o not allowed" 

103 "unformatted i/o not allowed" 

104 "direct i/o not allowed" 

105 "sequential i/o not allowed" 

106 "can't backspace file" 

107 "off beginning of record" 

108 "can't stat file" 

109 "no * after repeat count" 

110 "off end of record" 

111 "truncation failed" 

112 "incomprehensible list input" 

113 "out of free space" 

114 "unit not connected" g 

115 "invalid data for integer format term" ^ 



MIPS Computer Systems, Inc. February 13, 1989 Page 1 



PERROR ( 3F ) RISC/os Programmer's Reference PERROR ( 3F ) 



116 "invalid data for logical format term" 

117 "'new' file exists" 

118 "can't find 'old' file" 

119 "opening too many files or unknown system error" 

120 "requires seek ability" 

121 "illegal argument" 

122 "negative repeat count" 

123 "illegal operation for unit" 

124 "invalid data for d, e, f, or g format term" 
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NAME 

plot: openpl ? erase, label, line, circle, arc, move, cont, point, linemod, space, closepl - 
graphics interface 

SYNOPSIS 

openpIQ 

era&eQ 

label (s) 
char s[j; 

line(xl, yl, x2, y2) 

circle (x, y, r) 

are(x, y, x0 9 yO, xl, yl) 

move(x, y) 

cont(x, y) 

point(x, y) 

linemod (s) 
char sQ; 

space (xO , yO, xl, yl) 

closepl 

DESCRIPTION 

These subroutines generate graphic output in a relatively device-independent manner. See 
plot(5) for a description of their effect, openpl must be used before any of the others to open 
the device for writing, closepl flushes the output. 

String arguments to label and linemod are null-terminated, and do not contain newlines. 

Various flavors of these functions exist for different output devices. They are obtained by the 
following ld(l) options: 

-Iplot 



( 



-1300 
-1300s 

-1450 
-14013 

-14014 



-"Iplotaed 
— Iplotbg 
— lplotdumb 
-lplot 
-lvtO 

-lplot2648 
-lplot7221 
— Iplotimagen 



device-independent graphics stream on standard output for plot(l) 

filters 

GSI 300 terminal 

GSI 300S terminal 

GSI 450 terminal 

Tektronix 4013 terminal 

Tektronix 4014 and 4015 terminals with the Enhanced Graphics 

Module (Use -14013 for 4014's or 4015's without the Enhanced 

Graphics Module) 

A ED 512 color graphics terminal 

BBN bitgraph graphics terminal 

Dumb terminals without cursor addressing or line printers 

DEC Gigi terminals 

DEC vtlOO terminals 

Hewlett Packard 2648 graphics terminal 

Hewlett Packard 7221 graphics terminal 

Imagen laser printer (default 240 dots~per4nch resolution). 



( 
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On many devices, it is necessary to pause after eraseQ, otherwise plotting commands are lost. 
The pause is normally done by the tty driver if at login time, tset found a df field in the 
termcap(5) entry for the terminal. If a pause is needed but not automatically being generated, 
add 

flush(stdout); 

sleep(l); 
after each erase (). 

SEE ALSO 

plot(5), plot(lG), plot(3F), graph(lG) 
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NAME 

popen, pclose - initiate I/O to/from a process 

SYNOPSIS 

#include <stdio*h> 

FILE *popen (command, type) 
char *command, *type; 

pclose (stream) 
FILE *stream; 

DESCRIPTION 

The arguments to popen are pointers to null-terminated strings containing respectively a shell 
command line and an I/O mode, either Y' for reading or "w" for writing. It creates a pipe 
between the calling process and the command to be executed. The value returned is a stream 
pointer that can be used (as appropriate) to write to the standard input of the command or 
read from its standard output. 

A stream opened by popen should be closed by pclose , which waits for the associated process 
to terminate and returns the exit status of the command. 

Because open files are shared, a type V command may be used as an input filter, and a type 
M w" as an output filter. 

SEE ALSO 

pipe(2), fopen(3S), fclose(3S), system(3), wait(2), sh(l) 

DIAGNOSTICS 

popen returns a null pointer if files or processes cannot be created, or the shell cannot be 
accessed. 

pclose returns -1 if stream is not associated with a 'popened 5 command. 

ERRORS 

Buffered reading before opening an input filter may leave the standard input of that filter 
mispositioned. Similar problems with an output filter may be forestalled by careful buffer 
flushing, for instance, with fflush, see f close (3S). 

popen always calls sh , never calls csh . 



( 



MIPS Computer Systems, Inc. February 5, 1989 Page 1 



PRINTF ( 3S-BSD ) RISC/os Programmer's Reference PRINTF ( 3S-BSD ) 



NAME 

printf , fprintf , sprintf - formatted output conversion 

SYNOPSIS 

#include <stdio.h> 

printf (format [, arg ] ... ) 
char *format; 

fprintf (stream, format [, arg ] . . . ) 
FILE *stream; 
char *format; 

sprintf (s, format [, arg ] ... ) 
char *s, format; 

#include <varargs.h> 
_doprnt(format, args, stream) 
char *format; 
vajist *args; 
FILE *stream; 

DESCRIPTION 

printf places output on the standard output stream stdoiat, fprintf places output on the named 
output stream, sprintf places 'output' in the string s, followed by the character '\0\ It returns 
the first argument. All of these routines work by calling the internal routine _doprnt, using 
the variable-length argument facilities of varargs(3). 

Each of these functions converts, formats, and prints its arguments after the first under con- 
trol of the first argument. The first argument is a character string which contains two types of 
objects: plain characters, which are simply copied to the output stream, and conversion 
specifications, each of which causes conversion and printing of the next successive arg printf. 

Each conversion specification is introduced by the character %. The remainder of the conver- 
sion specification includes in the following order 

• Zero or more of following flags: 

• a '#' character specifying that the value should be converted to an "alternate 
form". For c, d, s, and u, conversions, this option has no effect. For o 
conversions, the precision of the number is increased to force the first charac- 
ter of the output string to a zero. For x(X) conversion, a non-zero result has 
the string Ox(OX) prepended to it. For e, E, f, g, and G, conversions, the 
result will always contain a decimal point, even if no digits follow the point 
(normally, a decimal point only appears in the results of those conversions if a 
digit follows the decimal point). For g and G conversions, trailing zeros are 
not removed from the result as they would otherwise be. 

• a minus sign '-' which specifies left adjustment of the converted value in the 
indicated field; 

• a '+' character specifying that there should always be a sign placed before the 
number when using signed conversions, 

• a space specifying that a blank should be left before a positive number during 
a signed conversion. A '+■' overrides a space if both are used. 

• an optional digit string specifying a field width; if the converted value has fewer charac- 
ters than the field width it will be blank-padded on the left (or right, if the left- 
adjustment indicator has been given) to make up the field width; if the field width 
begins with a zero, zero-padding will be done instead of blank-padding; 
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• an optional period V which serves to separate the field width from the next digit V 

string; 

• an optional digit string specifying a precision which specifies the number of digits to 
appear after the decimal point, for e- and ^conversion, or the maximum number of 
characters to be printed from a string; 

• the character 1 specifying that a following d, o, x, or u corresponds to a long integer 
arg. 

• a character which indicates the type of conversion to be applied. 

A field width or precision may be V instead of a digit string. In this case an integer arg sup- 
plies the field width or precision. 

The conversion characters and their meanings are 

dox The integer arg is converted to decimal, octal, or hexadecimal notation respectively. 

f The float or double arg is converted to decimal notation in the style '[-]ddd.ddd ? 

where the number of d's after the decimal point is equal to the precision specification 
for the argument. If the precision is missing, 6 digits are given; if the precision is 
explicitly 0, no digits and no decimal point are printed. 

e The float or double arg is converted in the style '[-]d»ddde±dd ? where there is one 

digit before the decimal point and the number after is equal to the precision 
specification for the argument; when the precision is missing, 6 digits are produced. 

g The float or double arg is printed in style d, in style f, or in style e, whichever gives 

full precision in minimum space. 

c The character arg is printed. | 

s Arg is taken to be a string (character pointer) and characters from the string are 

printed until a null character or until the number of characters indicated by the preci- 
sion specification is reached; however if the precision is or missing all characters up 
to a null are printed. 

o The unsigned integer arg is converted to decimal and printed (the result will be in the 

range through MAXUINT, where MAXUINT equals 4294967295 on a MIPS R2000). 
% Print a '%'; no argument is converted. 

In no case does a non-existent or small field width cause truncation of a field; padding takes 
place only if the specified field width exceeds the actual width. Characters generated by printf 
are printed by putc (3S). 

Examples 

To print a date and time in the form 'Sunday, July 3, 10:02"', where weekday and month are 

pointers to null-terminated strings: 

printf ("%s, %s %d, %02d:%02d", weekday, month, day, hour, min); 

To print 7T to 5 decimals: 

•printf ("pi = %.5f", 4*atan(1.0)); 

SEE ALSO 

putc(3S), scanf(3S), ecvt(3) 

ERRORS 

Very wide fields (>128 characters) fail. 
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NAME 

psignal, sys_siglist - system signal messages 

SYNOPSIS 

psignal (sig, s) 
unsigned sig; 
char *s; 

char *sys_siglist[]; 

DESCRIPTION 

psignal produces a short message on the standard error file describing the indicated signal. 
First the argument string s is printed, then a colon, then the name of the signal and a new- 
line. Most usefully, the argument string is the name of the program which incurred the signal. 
The signal number should be from among those found in <signal.h> . 

To simplify variant formatting of signal names, the vector of message strings $y$_jSigli$t is pro- 
vided; the signal number can be used as an index in this table to get the signal name without 
the newline. The define NSIG defined in <signalh> is the number of messages provided for 
in the table; it should be checked because new signals may be added to the system before they 
are added to the table. 

SEE ALSO 

sigvec(2), perror(3) 
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publiclib - public domain packages written in Ada 

DESCRIPTION 

publiclib contains the packages CHARACTERJTYPE and VSTRINGS. 

NOTE: These packages are neither supported by nor warranteed by MIPS. 

CHARACTERJTYPE provided the following character handling functions. 

ISLAPHA 

ISUPPER 

ISLOWER 

ISDIGIT 

ISXDIGIT 

ISALNUM 

ISSPACE 

ISPUNCT 

ISPRINT 

ISCNTRL 

ISASCII 

TOUPPER 

TOLOWER 

TO A SCII 

VSTRINGS provides string replacement, searching, concatenation, and other string functions 
with a simple syntac and the ability to transfer data between its own data representation and 
the predefined Ada type STRING. 

TYPES AND FUNCTIONS 

subtype ASCHJNTEGER in TOASCH function 
FILES 

lusrlvad$5! publiclib I* 
SEE ALSO 

examples, standard, verdixlib 



( 
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NAME 

putc, fputc - write a character to a fortran logical unit 

SYNOPSIS 

integer function putc (char) 
character char 

integer function fputc (lunit, char) 
character char 

DESCRIPTION 

These funtions write a character to the file associated with a fortran logical unit bypassing nor- 
mal fortran I/O. Putc writes to logical unit 6, normally cojinected to the control terminal out- 
put. 

The value of each function will be zero unless some error occurred; a system error code other- 
wise. See perror(3F). 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

putc(3S), intro(2), perror(3F) 
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NAME V 

putc, putchar, fputc, putw - put character or word on a stream 

SYNOPSIS 

#include <stdio.h> 

int putc(c 9 stream) 

char c; 

FILE *stream; 

int putchar (c) 

int fputc (c, stream) 
FILE *stream; 

int putw(w, stream) 
FILE *stream; 

DESCRIPTION 

putc appends the character c to the named output stream. It returns the character written. 

putchar(c) is defined as putc(c, stdout). 

fputc behaves like putc, but is a genuine function rather than a macro. 

putw appends word (that is, int) w to the output stream. It returns the word written, putw 
neither assumes nor causes special alignment in the file. 

SEE ALSO 

fopen(3S), fclose(3S), getc(3S), puts(3S), printf(3S), fread(3S) 

DIAGNOSTICS ^ 

These functions return the constant EOF upon error. Since this is a good integer, ferror(3$) I 

should be used to detect putw errors. 

ERRORS 

Because it is implemented as a macro, putc treats a stream argument with side effects improp- 
erly. In particular 

putc(c, *f++); 

doesn't work sensibly. 

Errors can occur long after the call to putc. 



( 
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NAME 

puts, fputs - put a string on a stream 

SYNOPSIS 

#include <stdio.h> 

puts(s) 
char *s; 

fputs (s, stream) 
char *s; 
FILE *stream; 

DESCRIPTION 

puts copies the null-terminated string s to the standard output stream stdout and appends a 
newline character, 

fputs copies the null-terminated string s to the named output stream . 

Neither routine copies the terminal null character. 

SEE ALSO 

fopen(3S), gets(3S), putc(3S), printf(3S), ferror(3S) 
fread(3S) for fwrite 

ERRORS 

puts appends a newline, fputs does not, all in the name of backward compatibility. 
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NAME 

qsort - quicker sort 

SYNOPSIS 

qsort (base, nel, width, compar) 
char *base; 
bit (*€ompar)0? 

DESCRIPTION 

qsort is an implementation of th$ quicker-sort algorithm. The first argument is a pointer to 
the base of the data; the second is the number of elements; the third is the width of an ele- 
ment m bytes; the last is the name of the comparison routine to be called with two arguments 
which are pointers to the dements being compared. The routine must return an integer less 
than, equal to, or greater than according as the first argument is to be considered less than, 
equal to, or greater than the second. 

SEE ALSO 

sort(l) 



( 



( 
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NAME 

qsort - quick sort 

SYNOPSIS 

subroutine qsort (array, len, isize, compar) 
external compar 
integer[*2] compar 

DESCRIPTION 

One dimensional array contains the elements to be sorted, len is the number of elements in 
the array, isize is the size of an element, typically - 

4 for integer and real 

8 for double precision or complex 

16 for double complex 

(length of character object) for character arrays 

Compar is the name of a user supplied integer or integer*2 function that will determine the 
sorting order. You must declare compar as external with the "external" statement to be recog- 
nized as a function. This function will be called with 2 arguments that will be elements of 
array. The function must return - ' 

negative if arg 1 is considered to precede arg 2 

zero if arg 1 is equivalent to arg 2 

positive if arg 1 is considered to follow arg 2 

On return, the elements of array will be sorted. 
/usr/lib/libU77.a 



FILES 



SEE ALSO 

qsort(3) 
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NAME 

rand ? srand - random number generator 

SYNOPSIS 

srand (seed) 
int seed; 

rand 

DESCRIPTION 

The newer random (3) should be used in new applications; rand remains for compatibilty. 

rand uses a multiplicative congruential random number generator with period 2 32 to return sue- 
cessive pseudo-random numbers in the range from to 2 31 -1. 

The generator is reinitialized by calling srand with 1 as argument. It can be set to a random 
starting point by calling srand with whatever you like as argument. 
SEE ALSO 

random(3) 



( 



c 
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NAME 

rand, irand, srand - random number generator 

SYNOPSIS 

integer iseed, i ? irand 
double precision s, rand 

call srand (iseed) 

i = irand() 

x = rand( ) 

DESCRIPTION 

Irand generates successive pseudo-random integers in the range from to 2**15-1. rand gen- 
erates pseudo-random numbers distributed in [-, 1.0]. Srand uses its integer argument to reini- 
tialize the seed for successive invocations of irand and rand. 

SEE ALSO 

rand(3C). 
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NAME 

random, srandom, initstate, setstate - better random number generator; routines for changing 
generators 

SYNOPSIS 

long random 

srandom (seed) 
int seed; 

char *initstate(seed, state, n) 

unsigned seed; 

char * state; 

int n; 

char *set$tate (state) 

char estate; 

DESCRIPTION 

random uses a non-linear additive feedback random number generator employing a default 
table of size 31 long integers to return successive pseudo-random numbers in the range from 
to 2 —1. The period of this random number generator is very large, approximately 
16x(2 31 -l). 

random/ srandom have (almost) the same calling sequence and initialization properties as 
rand/srand. The difference is that rand(3) produces a much less random sequence - in fact, 
the low dozen bits generated by rand go through a cyclic pattern. All the bits generated by 
random are usable. For example, "randomQ&Ol" will produce a random binary value. 

Unlike srand, srandom does not return the old seed; the reason for this is that the amount of v- 

state information used is much more than a single word. (Two other routines are provided to ■ 

deal with restarting/changing random number generators). Like rand (3), however, random 
will by default produce a sequence of numbers that can be duplicated by calling srandom with 
1 as the seed. 

The initstate routine allows a state array, passed in as an argument, to be initialized for future 
use. The size of the state array (in bytes) is used by initstate to decide how sophisticated a 
random number generator it should use - the more state, the better the random numbers will 
be. (Current "optimal" values for the amount of state information are 8, 32, 64 ? 128, and 256 
bytes; other amounts will be rounded down to the nearest known amount. Using less than 8 
bytes will cause an error). The seed for the initialization (which specifies a starting point for 
the random number sequence, and provides for restarting at the same point) is also an argu- 
ment. Initstate returns a pointer to the previous state information array. 

Once a state has been initialized, the setstate routine provides for rapid switching between 
states, setstate returns a pointer to the previous state array; its argument state array is used for 
further random number generation until the next call to initstate or setstate. 

Once a state array has been initialized, it may be restarted at a different point either by calling 
initstate (with the desired seed, the state array, and its size) or by calling both setstate (with the 
state array) and srandom (with the desired seed). The advantage of calling both setstate and 
srandom is that the size of the state array does not have to be remembered after it is initial- 
ized. 

With 256 bytes of state information, the period of the random number generator is greater 
than 2 , which should be sufficient for most purposes. 

AUTHOR 

Earl T. Cohen 
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DIAGNOSTICS 

If initiate is called with less than 8 bytes of state information, or if setstate detects that the 
state information has been garbled, error messages are printed on the standard error output. 

SEE ALSO 

rand(3) 

ERRORS 

About 2/3 the speed of rand (3C), 
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NAME 

ranhashinit, ranhash, ranlookup - access routine for the symbol table definition file in 
archives 

SYNOPSIS 

#incliide <ar»h> 

int ranhashinit (pran, pstr, size) 
struct ranlib *pran; 
char *pstr; 
int size; 

ranhash(name) 
char *name; 

struct ranlib *ranhash(name) 
char *name; 

DESCRIPTION 

Ranhashinit initializes static information for future use by ranhash and ranlookup. Fran points 
to an array of ranlib structures. Pstr points to the corresponding ranlib string table (these are 
only used by ranlookup). Size is the size of the hash table and should be a power of 2. If the 
size isn't a power of 2, a 1 is returned; otherwise, a is returned. 

Ranhash returns a hash number given a name. It uses a multiplicative hashing algorithm and 
the size argument to ranhashinit. 

Ranlookup looks up name in the ranlib table specified by ranhashinit. It uses the ranhash rou- 
tine as a starting point. Then, it does a rehash from there. This routine returns a pointer to a 
valid ranlib entry on a match. If no matches are found (the "emptiness" can be inferred if the £ 

ran_off field is zero), the empty ranlib structure hash table should be sparse. This routine \ 

does not expect to run out of places to look in the table. For example, if you collide on all 
entries in the table, an error is printed tostderr and a zero is returned. 

AUTHOR 

Mark I. Himelstein 

SEE ALSO 

ar(l), ar.h(5). 



c 
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NAME 

rcmd, rresvport, ruserok - routines for returning a stream to a remote command 

SYNOPSIS 

rem = rcmd(ahost, in port, locuser, remuser, cmd, fd2p); 

char **ahost; 

int inport; 

char *locu$er 9 *remuser ? *cmd; 

int *fd2p; 

s ss rresvport (port); 
int *port; 

ruserok(rho$t, superuser, ruser, luser); 
char *rhost; 
int superuser; 
char *ruser, *luser; 

DESCRIPTION 

rcmd is a routine used by the super-user to execute a command on a remote machine using an 
authentication scheme based on reserved port numbers, rresvport is a routine which returns a 
descriptor to a socket with an address in the privileged port space, ruserok is a routine used 
by servers to authenticate clients requesting service with rcmd. All three functions are present 
in the same file and are used by the rshd (8C) server (among others). 

rcmd looks up the host mhost using gethostbyname(3N), returning -1 if the host does not 
exist. Otherwise *aho$t is set to the standard name of the host and a connection is established 
to a server residing at the well-known Internet port inport. 

If the connection succeeds, a socket in the Internet domain of type SOCK_STREAM is 
returned to the caller, and given to the remote command as stdin and stdout. If fd2p is non- 
zero, then an auxiliary channel to a control process will be set up, and a descriptor for it will 
be placed in *fd2p. The control process will return diagnostic output from the command (unit 
2) on this channel, and will also accept bytes on this channel as being UNIX signal numbers, 
to be forwarded to the process group of the command. If fd2p is 0, then the stderr (unit 2 of 
the remote command) will be made the same as the stdout and no provision is made for send- 
ing arbitrary signals to the remote process, although you may be able to get its attention by 
using out-of-band data. 

The protocol is described in detail in rshd(8C). 

The rresvport routine is used to obtain a socket with a privileged address bound to it. This 
socket is suitable for use by rcmd and several other routines. Privileged Internet ports are 
those in the range to 1023. Only the super-user is allowed to bind an address of this sort to 
a socket. 

ruserok takes a remote host's name, as returned by a gethostbyaddr(3N) routine, two user 
names and a flag indicating whether the local user's name is that of the super-user. It then 
checks the files /etc/hosts. equiv and, possibly, .rhosts in the user's home directory to see if the 
request for service is allowed. A is returned if the machine name is listed in the 
"hosts. equiv" file, or the host and remote user name are found in the ".rhosts" file; otherwise 
ruserok returns -1. If the superuser flag is 1, the checking of the "host. equiv" file is bypassed. 
If the local domain (as obtained from gethostname (2)) is the same as the remote domain, only 
the machine name need be specified. 

SEE ALSO 

rlogin(lC), rsh(lC), intro(2), rexec(3), rhosts(5), rexecd(8C), rlogind(8C), rshd(8C) 



MIPS Computer Systems, Inc. February 5, 1989 Page 1 



RCMD ( 3^-BSD ) RISC/os Programmer's Reference RCMD ( 3-BSD ) 



DIAGNOSTICS 

rcmd returns a valid socket descriptor on success. It returns -1 on error and prints a diagnos- 
tic message on the standard error. 

rresvport returns a valid, bound socket descriptor on success. It returns -1 on error with the 
global value errno set according to the reason for failure. The error code EAGAIN is over- 
loaded to mean "All network ports in use." 



c 



( 



( 
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NAME 

re_comp, re_exec - regular expression handler 

SYNOPSIS 

char *re_comp(s) 
char *s; 

re_exec(s) 
char *s; 

DESCRIPTION 

rejcomp compiles a string into an internal form suitable for pattern matching, re^exec checks 
the argument string against the last string passed to rejcomp. 

rejcomp returns if the string s was compiled successfully; otherwise a string containing an 
error message is returned. If rejcomp is passed or a null string, it returns without changing 
the currently compiled regular expression. 

re_exec returns 1 if the string s matches the last compiled regular expression, if the string s 
failed to match the last compiled regular expression, and -1 if the compiled regular expression 
was invalid (indicating an internal error) . 

The strings passed to both rejcomp and rejexec may have trailing or embedded newline char- 
acters; they are terminated by nulls. The regular expressions recognized are described in the 
manual entry for ed(l), given the above difference. 

SEE ALSO 

ed(l), ex(l), egrep(l), fgrep(l), grep(l) 

DIAGNOSTICS 

re^exec returns -1 for an internal error, 

re_comp returns one of the following strings if an error occurs: 

No previous regular expression, 

Regular expression too long, 

unmatched \(, 

missing J, 

too many \(\) pairs, 

unmatched \). 
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NAME I 

res„mkquery ? res_send ? resjnit, dn__comp, dn_expand - resolver routines 

SYNOPSIS 

#!ncliide <sys/types.h> 
#include <netinet/in.h> 

#iraelude <arpa/eameser.h> 
#include <res©lv»h> 

res_jmkquery(op 9 dname, class, type, data, datalen, newrr 9 bisf, buflen) 

int op; 

char *dname; 

Int class ? type; 

char *data; 

Int datalen; 

struct tree *newrr; 

char *buf; 

Int buflen; 

res__send(msg 9 msglen,' answer, anslen) 
char *msg; 
Int msglen; 

char *answer; 

Int anslen; 

resJnltQ 

dn_eomp(exp_dii, comp„dn 9 length, dnptrs, lastdnptr) 

char *exp„dn, *comp_dn; f 

Int length; "V 

char **dnptrs, «lastdnptr; 

dnuexpand(msg, eomorig, comp„dn, exp__dn, length) 
char *msg, *eomorlg, *eomp__dn, exp.dn; 
Int length; 

DESCRIPTION 

These routines are used for making, sending and interpreting packets to Internet domain name 
servers. Global information that is used by the resolver routines is kept in the variable _res. 
Most of the values have reasonable defaults and can be ignored. Options stored in jre$. options 
are defined in resolv.h and are as follows. Options are a simple bit mask and are or ? ed in to 
enable. 

RESJNXT 

True if the initial name server address and default domain name are initialized (i.e., 
resjnit has been called). 

RESJ3EBUG 

Print debugging messages. 

RES_AAONLY 

Accept authoritative answers only. res_$end will continue until it finds an authoritative 
answer or finds an error. Currently this is not implemented. 

FRES_USEVC 

Use TCP connections for queries instead of UDP. 

RES_STAYOPEN 

Used with RESJIJSEVC to keep the TCP connection open between queries. This is f 

useful only in programs that regularly do many queries. UDP should be the normal ' V 
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mode used. 

RESJGNTC 

Unused currently (ignore truncation errors, i.e., don't retry with TCP). 

RESJIECURSE 

Set the recursion desired bit in queries. This is the default. ( res_send does not do 
iterative queries and expects the name server to handle recursion.) 

RESJDEFNAMES 

Append the default domain name to single label queries. This is the default. 

resjnit 

reads the initialization file to get the default domain name and the Internet address of the ini- 
tial hosts running the name server. If this line does not exist, the host running the resolver is 
tried, resjnkquery makes a standard query message and places it in huf. resjnkquery will 
return the size of the query or -1 if the query is larger than buflen . op is usually QUERY but 
can be any of the query types defined in narneser.h . dname is the domain name. If dname 
consists of a single label and the RES_PEFNAMES flag is enabled (the default), dname will be 
appended with the current domain name. The current domain name is defined in a system file 
and can be overridden by the environment variable LOCALDOMAIN. newrr is currently 
unused but is intended for making update messages. 

resjsend sends a query to name servers and returns an answer. It will call resjnit if RESJNIT 
is not set, send the query to the local name server, and handle timeouts and retries. The 
length of the message is returned or -1 if there were errors. 

dn„expand expands the compressed domain name compj&n to a full domain name. Expanded 
names are converted to upper case, msg is a pointer to the beginning of the message, expjdn 
is a pointer to a buffer of size length for the result. The size of compressed name is returned 
or -1 if there was an error. 

dnjcornp compresses the domain name expjdn and stores it in compjdn. The size of the 
compressed name is returned or -1 if there were errors, length is the size of the compjdn. 
dnptrs is a list of pointers to previously compressed names in the current message. The first 
pointer points to to the beginning of the message and the list ends with NULL, lastdnptr is a 
pointer to the end of the array pointed to dnptrs. A side effect is to update the list of pointers 
for labels inserted into the message by dnjcomp as the name is compressed. If dnptr is NULL, 
we don't try to compress names. If lastdnptr is NULL, we don't update the list. 



FILES 



/etc/resolv.conf see resolver(5) 



SEE ALSO 

named(8), resolver(5), RFC882, RFC883, RFC973, RFC974, SMM:11 Name Server Opera- 
tions Guide for BIND 
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NAME I 

rex - remote execution protocol 

SYNOPSIS 

#include <$ys/iocthh> 
#include <rpcsvc/rex.h> 

DESCRIPTION 

This server will execute commands remotely, the working directory and environment of the 
command can be specified, and the standard input and output of the command can be arbi- 
trarily redirected. An option is provided for interactive I/O for programs that expect to be 
running on terminals. Note that this service is only provided with the TCP transport. 

RPC INFO 

program number: 

REXPROG 

xdr routines: 

int xdr_jex__start(xdrs, start); 

XDR *xdrs; 

struct rex_start *start; 
int xdr_rex_jresult(xdrs, result); 

XDR *xdrs; 

struct rex_result *result; 
int xdr_rex_ttymode(xdrs, mode); 

XDR *xdrs; 

struct rex_ttymode *mode; 
int xdr_jexj;tysize(xdrs, sue); £ 

XDR *xdrs; ^ 

struct ttysize *size; 

procs: 

REXPROC.START 

Takes rex_start structure, starts a command executing, 

and returns a rex_„result structure. 
REXPROCJWAIT 

Takes no arguments, waits for a command to finish executing, 

and returns a rex^result structure. 
REXPROQ.MODES 

Takes a rexJ:tymode structure, and sends the tty modes. 
REXPROCJWINCH 

Takes a ttysize structure, and sends window size information, 
versions: 

REXVERS^ORIG 

Original version 
structures: 

#define REXJNTERACTIVE 1 /* Interative mode */ 

struct rex_start { 

char **rst_cmd; /* list of command and args */ 

char *rst_host; /* working directory host name */ 

char *rst_lsname; /* working directory file system name */ 

char *rst_dirwithin; /* working directory within file system */ 

char **rst_env; /* list of environment */ 

u_short rst_portO; /* port for stdin */ £ 

u_short rst_portl; /* port for stdin */ V 
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}; 



u_short rst_port2; 
u_long rst_flags; 



struct rex_result { 

int rlt_stat; 

char *rlt_jmessage; 

}; 

struct rex_ttymode { 

struct sgttyb basic; 
struct tchars more; 
struct Itchars yetmore; 
ujong andmore; 

}; 

SEE ALSO 

on(lC), rexd(8C) 



/* port for stdin */ 

/* options - see #defines above */ 



/* integer status code */ 

/* string message for human consumption */ 



/* standard unix tty flags */ 
/* interrupt, kill characters, etc. */ 
/* special Berkeley characters */ 
/* and Berkeley modes */ 
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NAME ^ 

rexec - return stream to a remote command 

SYNOPSIS 

rem = rexec (aho$t ? inport, user, passwd, cmd 9 fd2p); 
char **ahost; 
int Inport; 

char *user ? *passwd 9 *cmd; 
int *fd2p; 

DESCRIPTION 

rexec looks up the host *ahost using gethostbyname(3N), returning -1 if the host does not 
exist. Otherwise whost is set to the standard name of the host. If a username and password 
are both specified, then these are used to authenticate to the foreign host; otherwise the 
environment and then the user's Metre file in his home directory are searched for appropriate 
information. If all this fails, the user is prompted for the information. 

The port inport specifies which well-known DARPA Internet port to use for the connection; 
the call "getservbyname("exec", "tcp")" (see getsefvent(3N)) will return a pointer to a structure' 
which contains the necessary port. The protocol for connection is described in detail in 
rexecd(8C). 

If the connection succeeds, a socket in the Internet domain of type SOCK_STREAM is 
returned to the caller, and given to the remote command as stdin and stdout. Tlfd2p is non- 
zero, then an auxiliary channel to a control process will be setup, and a descriptor for it will 
be placed in *fd2p . The control process will return diagnostic output from the command (unit 
2) on this channel, and will also accept bytes on this channel as being UNIX signal numbers, 
to be forwarded to the process group of the command. The diagnostic information returned f 

does not include remote authorization failure, as the secondary connection is set up after V 

authorization has been verified. If fd2p is 0, then the stderr (unit 2 of the remote command) 
will be made the same as the stdout and no provision is made for sending arbitrary signals to 
the remote process, although you may be able to get its attention by using out-of-band data. 
SEE ALSO 

rcmd(3), rexecd(8C) 



( 
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NAME 

rnusers, rusers - return information about users on remote machines 

SYNOPSIS 

#include <rpcsvc/rusers«h> 

rnusers(host) 

char *host 

rusers (host, up) 

char *host 

struct utmpidlearr *up; 

DESCRIPTION 

Rnusers returns the number of users logged on to host (-1 if it cannot determine that number). 
rusers fills the utmpidlearr structure with data about host, and returns if successful. The 
relevant structures are: 

struct utmparr { /* RUSERSVERS J3RIG */ 

struct utmp **uta_arr; 
int uta_cnt 

}; 

struct utmpidle { 

struct utmp uLutmp; 
unsigned uLidle; 

}; 

struct utmpidlearr { /* RUSERSVERS.JDLE */ 

struct utmpidle **uia_arr; 
int uia_cnt 

}; 

RPC INFO 

program number: 

RUSERSPROG 

xdr routines: 

int xdr__utmp(xdrs ? up) 

XDR *xdrs; 

struct utmp *up; 
int xdr„utmpidle(xdrs, ui); 

XDR *xdrs; 

struct utmpidle *ui; 
int xdr_utmpptr(xdrs, up); 

XDR *xdrs; 

struct utmp **up; 
int xdr„utmpidleptr(xdrs, up); 

XDR *xdrs; 

struct utmpidle **up; 
int xdr_utmparr(xdrs, up); 

XDR *xdrs; 

struct utmparr *up; 
int xdr„utmpidlearr(xdrs, up); 

XDR *xdrs; 

struct utmpidlearr *up; 

procs: 
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RUSERSPROC_NUM ^ 

No arguments, returns number of users as an unsigned long. 
RUSERSPROCJNTAMES 

No arguments, returns utmparr or utmpidlearr, depending on version number. 
RUSERSPROC_ALLNAMES 

No arguments, returns utmparr or utmpidlearr, depending on version number. 

Returns listing even for utmp entries satisfying nonuserQ in utmp.h, 
versions: 

RUSERSVERS^ORIG 
RUSERSVERSJDLE 

structures: 

SEE ALSO 

rusers(lC) 



( 



( 
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NAME 



rpc - library routines for remote procedure calls 



DESCRIPTION 

These routines allow C programs to make procedure calls on other machines across the net- 
work. First, the client calls a procedure to send a data packet to the server. Upon receipt of 
the packet, the server calls a dispatch routine to perform the requested service, and then 
sends back a reply. Finally, the procedure call returns to the client. 



FUNCTIONS 

auth_destroy() 

authnone_create() 

authunix_create() 

authunix_create_default() 

callrpc() 

clnt_broadcast() 

clnt_call() 

clnt_destroy() 

clnt_freeres() 

clnt_geterr() 

clnt_pcreateerror() 

clnt_perrno() 

clnt_perror() 

clnt_sperrno() 

clnt„sperror() 

clntraw_create() 

clnttcp_create() 

clntudp__create() 

get_myaddress() 

pmap_getmaps() 

pmap_getport() 

pmap__rmtcall() 

pmap_set() 

pmap_unset() 

registerrpc() 

rpc_createerr 

svc_destroy() 

svc_fds 

svc_freeargs() 

svc„getargs() 

svc_getcaller() 

svc_getreq() 

svc_jregister() 

svc_jun() 

svc__sendreply() 

svc_unregister() 

svcerr_auth() 

svcerr__decode() 

svcerr__noproc() 

svcerr_noprog() 

svcerr_progvers() 

svcerr_systemerr() 

svcerr_weakauth() 

svcraw__create() 



destroy authentication information handle 

return RPC authentication handle with no checking 

return RPC authentication handle with UNIX permissions 

return default UNIX authentication handle 

call remote procedure, given [prognum,versnum,procnum] 

broadcast remote procedure call everywhere 

call remote procedure associated with client handle 

destroy client's RPC handle 

free data allocated by RPC/XDR system when decoding results 

copy error information from client handle to error structure 

print message to stderr about why client handle creation failed 

print message to stderr corresponing to condition given 

print message to stderr about why RPC call failed 

print message to a string corresponding to condition given 

print message to a string 

create toy RPC client for simulation 

create RPC client using TCP transport 

create RPC client using UDP transport 

get the machine's IP address 

return list of RPC program-to-port mappings 

return port number on which waits supporting service 

instructs portmapper to make an RPC call 

establish mapping between [prognum,versnum,procnum] and port 

destroy mapping between [prognum,versnum,procnum] and port 

register procedure with RPC service package 

global variable indicating reason why client creation failed 

destroy RPC service transport handle 

global variable with RPC service file descriptor mask 

free data allocated by RPC/XDR system when decoding arguments 

decodes the arguments of an RPC request 

get the network address of the caller of a procedure 

returns when all associated sockets have been serviced 

associates prognum and versnum with service dispatch procedure 

wait for RPC requests to arrive and call appropriate service 

send back results of a remote procedure call 

remove mapping of [prognum, versnum] to dispatch routines 

called when refusing service because of authentication error 

called when service cannot decode its parameters 

called when service hasn't implemented the desired procedure 

called when program is not registered with RPC package 

called when version is not registered with RPC package 

called when service detects system error 

called when refusing service because of insufficient authentication 

creates a toy RPC service transport for testing 
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svctcp„create() 

svcudp„create() 

xdr„accepted„reply() 

xdr_authunix__parms() 

xdr„callhdr() 

xdr„callmsg() 

xdr„opaque_auth() 

xdr_pmap() 

xdr_pmaplist() 

xdr_rejected_reply() 

xdr_replymsg() 

xprt_jregister() 

xprt„uriregister() 

SEE ALSO 

Remote Procedure Call 



creates an RFC service based on TCP transport 
creates an RPC service based on UDP transport 
generates RPC-style replies without using RPC package 
generates UNIX credentials without using RPC package 
generates RPC-style headers without using RPC package 
generates RPC-style messages without using RPC package 
describes RPC messages, externally 
describes parameters for portmap procedures, externally 
describes a list of port mappings, externally 
generates RPC-style rejections without using RPC package 
generates RPC-style replies without using RPC package 
registers RPC service transport with RPC package 
unregisters RPC service transport from RPC package 

Programming Guide , in Networking on the Sun Workstation . 
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NAME 

rquota - implement quotas on remote machines 

SYNPOSIS 

#include <rpcsvc/rquota.h> 

RPC INFO 

program number: 

RQUOTAPROG 

xdr routines: 

xdr„getquota__args(xdrs ? gqa); 

XDR *xdrs; 

struct getquota_args *gqa; 
xdr_getquota_rslt(xdrs, gqr); 

XDR *xdrs; 

struct getquota^rslt *gqr; 
xdr_jrquota(xdrs, rq); 

XDR *xdrs; 

struct rquota *rq; 
procs: 

RQUOTAPROC.GETQUOTA 
RQUOTAPROC_GETACTIVEQUOTA 

Arguments of struct getquotajxrgs. 

Returns struct getquotajrsli , 

Uses UNIX authentication. 

Returns quota only on filesystems with quota active. 

versions: 

RQUOTA VERS J3RIG 



structures: 

struct getquota„args { 

char *gqa__pathp; 
int gqa_uid; 

}; 
/* 

* remote quota structure 
*/ 
struct rquota { 

int rq_bsize; 

booLt rq_active; 

ujong rqj>hardlimit; 

u_long rq_bsoftlimit; 

ujong rq_curblocks; 

ujong rqjliardlimit; 

ujong rqjsoftlimit; 

ujong rq_curfiles; 

ujong rq_btimeleft; 

ujong rqjtimeleft; 

}; 

enum gqr_status { 
&_OK = 1, 
Q_NOQUOTA - 2, 
CLEPERM = 3 



/* path to filesystem of interest */ 
/* inquire about quota for uid */ 



/* block size for block counts */ 

/* indicates whether quota is active */ 

/* absolute limit on disk blks alloc */ 

/* preferred limit on disk blks */ 

/* current block count */ 

/* absolute limit on allocated files */ 

/* preferred file limit */ 

/* current # allocated files */ 

/* time left for excessive disk use */ 

/* time left for excessive files */ 



/* quota returned */ 

/* noquota for uid */ 

/* no permission to access quota */ 
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>; ( 

struct getquotajrslt { 

enum-gqr^status gqr_status; /* discriminant */ 

struct rquota gqr_rquota; /* valid if status =*=* CLOK */ 

}; 

SEE ALSO 

quota(l), quotactl(2) 



c 
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NAME 

rwall - write to specified remote machines 

SYNOPSIS 

#include <rpcsvc/rwall.h> 

rwall (host, msg); 

char *host, *msg; 

DESCRIPTION 

rwall causes host to print the string msg to all its users. It returns if successful. 

RPC INFO 

program number: 

WALLPROG 

procs: 

WALLPROCLWALL 

Takes string as argument (wrapstring), returns no arguments. 
Executes wall on remote host with string, 
versions: 

RSTATVERS^ORIG 

SEE ALSO 

rwall(l), shutdown(8), rwalld(8C) 
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NAME I 

scandir, alphasort - scan a directory ^ 

SYNOPSIS 

#include <sys/types.h> 

#inelude <&y$/dir<,h> 

&candir(dimame 9 eamelist 9 select, compar) 

char *dirname; 

struct direct *(*iiamelist[]); 

Int (*select)0; 

bit (*compar)0; 

aIphasort(dl f d2) 

struct direct. **dl, **d2; 

DESCRIPTION 

scandir reads the directory dirname and builds an array of pointers to directory entries using 
malloc{3). It returns the number of entries in the array and a pointer to the array through 
namelist. 

The select parameter is a pointer to a user supplied subroutine which is called by scandir to 
select which entries are to be included in the array. The select routine is passed a pointer to a 
directory entiy and should return a non-zero value if the directory entry is to be included in 
the array. If select is null, then all the directory entries will be included. 

The compar parameter is a pointer to a user supplied subroutine which is passed to qsort{3) to 
sort the completed array. If tliis pointer is null, the array is not sorted, alphasort is a routine 
which can be used for the compar parameter to sort the array alphabetically. 

The memory allocated for the array can be deallocated with free (see malloc(3)) by freeing |^ 

each pointer in the array and the array itself. 

SEE ALSO 

directory(3), malloc(3), qsort(3) 5 dir(5) 

DIAGNOSTICS 

Returns -1 if the directory cannot be opened for reading or if malloc(3) cannot allocate 
enough memory to hold all the data structures. 



( 
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NAME 

scanf, fscanf, sscanf - formatted input conversion 

SYNOPSIS 

#include <stdio.h> 

scanf (format [ , pointer ] . . . ) 
char *format; 

fscanf(stream 9 format [ , pointer ] . . . ) 
FILE *$tream; 
char *format; 

sscanf(s, format [ , pointer ] . . . ) 
char *s, *format; 

DESCRIPTION 

scanf reads from the standard input stream stdin. f scanf reads from the named input stream, 
sscanf reads from the character string s. Each function reads characters, interprets them 
according to a format, and stores the results in its arguments. Each expects as arguments a 
control string format, described below, and a set of pointer arguments indicating where the 
converted input should be stored. 

The control string usually contains conversion specifications, which are used to direct interpre- 
tation of input sequences. The control string may contain: 

1. Blanks, tabs or newlines, which match optional white space in the input. 

2. An ordinary character (not %) which must match the next character of the input stream. 

3. Conversion specifications, consisting of the character %, an optional assignment suppress- 
ing character *, an optional numerical maximum field width, and a conversion character. 

A conversion specification directs the conversion of the next input field; the result is placed in 
the variable pointed to by the corresponding argument, unless assignment suppression was 
indicated by *. An input field is defined as a string of non-space characters; it extends to the 
next inappropriate character or until the field width, if specified, is exhausted. 

The conversion character indicates the interpretation of the input field; the corresponding 
pointer argument must usually be of a restricted type. The following conversion characters are 
legal: 

% a single s % ? is expected in the input at this point; no assignment is done. 

d a decimal integer is expected; the corresponding argument should be an integer pointer. 

o an octal integer is expected; the corresponding argument should be a integer pointer. 

x a hexadecimal integer is expected; the corresponding argument should be an integer 
pointer. 

s a character string is expected; the corresponding argument should be a character pointer 
pointing to an array of characters large enough to accept the string and a terminating '\0', 
which will be added. The input field is terminated by a space character or a newline. 

c a character is expected; the corresponding argument should be a character pointer. The 
normal skip over space characters is suppressed in this case; to read the next non-space 
character, try '%ls\ If a field width is given, the corresponding argument should refer to 
a character array, and the indicated number of characters is read. 

e a floating point number is expected; the next field is converted accordingly and stored 
f through the corresponding argument, which should be a pointer to afloat. The input for- 
mat for floating point numbers is an optionally signed string of digits possibly containing a 
decimal point, followed by an optional exponent field consisting of an E or e followed by 
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an optionally signed integer. m 

[ indicates a string not to be delimited by space characters. The left bracket is followed by 
a set of characters and a right bracket; the characters between the brackets define a set of 
characters making up the string. If the first character is not circumflex O, the input field 
is all characters until the first character not in the set between the brackets; if the first 
character after the left bracket is ", the input field is all characters until the first character 
which is in the remaining set of characters between the brackets. The corresponding 
argument must point to a character array. 

The conversion characters d, o and £ may be capitalized or preceded by 1 to indicate that a 
pointer to long rather than to int is in the argument list. Similarly, the conversion characters e 
or f may be capitalized or preceded by 1 to indicate a pointer to double rather than to float. 
The conversion characters d, o and x may be preceded by h to indicate a pointer to short 
rather than to int. 

The scanf functions return the number of successfully matched and assigned input items. This 
can be used to decide how many input items were found. The constant EOF is returned upon 
end of input; note that this is different from 0, which means that no conversion was done; if 
conversion was intended, it was frustrated by an inappropriate character in the input. 

For example, the call 

int i; float x; char name[50]; 
scanfC'%d%f%s", &i, &x, name); 

with the input line 

25 54.32E-1 thompson 

will assign to i the value 25, x the value 5.432, and name will contain 'thomp$on\0' . Or, 

int i; float x; char name[50]; 

scanf( ,, %2d%f%*d%[1234567890]", &i, &x, name); 

with input 

56789 0123 56a72 

will assign 56 to /, 789.0 to x, skip '0123', and place the string '56\0' in name. The next call to 
getchar will return fi a\ 

SEE ALSO 

atof(3), getc(3S), printf(3$) 

DIAGNOSTICS 

The scanf functions return EOF on end of input, and a short count for missing or illegal data 
items. 

ERRORS 

The success of literal matches and suppressed assignments is not directly determinable. 



( 
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NAME 

setbuf , setbuffer, setlinebuf - assign buffering to a stream 

SYNOPSIS 

#include <stdio.h> 

setbuf($tream, buf) 
FILE *stream; 
char *buf; 

setbuffer(stream 9 buf, size) 
FILE *stream; 
char *buf; 
int size; 

setlinebuf(stream) 
FILE *stream; 

DESCRIPTION 

The three types of buffering available are unbuffered, block buffered, and line buffered. 
When an output stream is unbuffered, information appears on the destination file or terminal 
as soon as written; when it is block buffered many characters are saved up and written as a 
block; when it is line buffered characters are saved up until a newline is encountered or input 
is read from stdin. fflush (see f close (38)) may be used to force the block out early. Normally 
all files are block buffered. A buffer is obtained from malloc(3) upon the first getc or putc(3S) 
on the file. If the standard stream stdout refers to a terminal it is line buffered. The standard 
stream stderr is always unbuffered. 

setbuf is used after a stream has been opened but before it is read or written. The character 
array buf is used instead of an automatically allocated buffer. If buf is the constant pointer 
NULL, input/output will be completely unbuffered. A manifest constant BUFSIZ tells how big 
an array is needed: 

char buf [BUFSIZ]; 
setbuffer, an alternate form of setbuf, is used after a stream has been opened but before it is 
read or written. The character array buf whose size is determined by the size argument is used 
instead of an automatically allocated buffer. If buf is the constant pointer NULL, input/output 
will be completely unbuffered. 

setlinebuf is used to change stdout or stderr from block buffered or unbuffered to line buffered. 
Unlike setbuf and setbuffer it can be used at any time that the file descriptor is active. 
A file can be changed from unbuffered or line buffered to block buffered by using freopen (see 
fopen(3S)). A file can be changed from block buffered or line buffered to unbuffered by using 
freopen followed by setbuf with a buffer argument of NULL. 

SEE ALSO 

fopen(3S), getc(3S), putc(3S), malloc(3), fclose(3S), puts(3S), printf(3S), fread(3S) 

ERRORS 

The standard error stream should be line buffered by default. 

The setbuffer and setlinebuf functions are not portable to non-4 .2BSP versions of UNIX. On 
4.2BSD and 4.3BSD systems, setbuf always uses a suboptimal buffer size and should be 
avoided, setbuffer is not usually needed as the default file I/O buffer sizes are optimal. 
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NAME f 

setjmp., longjmp - non4ocal goto 

SYNOPSIS 

#include <$etjmp„h> 

setjmp (env) 
jmpjbuf env; 

longjmp (env 9 val) 
jmp__buf env; 

_setjmp(env) 
jmpjbuf env; 

Jongjmp (env 9 val) 

jmpjbuf env; 

DESCRIPTION 

These routines are useful for dealing with errors and interrupts encountered in a low-level sub- 
routine of a program. 

setjmp saves its stack environment in env for later use by longjmp. It returns value 0. 

longjmp restores the environment saved by the last call of setjmp. It then returns in such a 
way that execution continues as if the call of setjmp had just returned the value val to the func- 
tion that invoked setjmp, which must not itself have returned in the interim. All accessible 
data have values as of the time longjmp was called. 

setjmp and longjmp save and restore the signal mask sigmask(2), while jsetjmp and Jongjmp 
manipulate only the C stack and registers. f 

ERRORS \ 

If the contents of the jmpjbuf are corrupted, or correspond to an environment that has 
already returned, longjmp calls the routine longjmperror . If longjmperror returns the program 
is aborted. The default version of longjmperror prints the message "Jongjmp botch" to stan- 
dard error and returns. User programs wishing to exit more gracefully can write their own ver- 
sions of longjmperror . 

SEE ALSO 

sigvec(2), sigstack(2), signal(3) 

BUGS 

The System V version of longjmp () will turn a return value of into a 1, whereas the BSD ver- 
sion always returns the value requested. A number of programs in BSD systems rely on the 
current behavior. 



( 
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NAME 

setuid, seteuid, setruid, setgid, setegid, setrgid - set user and group ID 

SYNOPSIS 

#include <sys/types.h> 

setuid (uid) 
seteuid(euid) 
setruid (ruid) 
uid_t uid 9 euid, ruid; 

setgid (gid) 
setegid(egid) 
setrgid (rgid) 
gid^t gid, egid, rgid; 

DESCRIPTION 

setuid (setgid) sets both the real and effective user ID (group ID) of the current process to as 

specified. 

seteuid (setegid) sets the effective user ID (group ID) of the current process, 

setruid (setrgid) sets the real user ID (group ID) of the current process. 

These calls are only permitted to the super-user or if the argument is the real or effective ID. 

SEE ALSO 

setreuid(2), setregid(2), getuid(2), getgid(2) 

DIAGNOSTICS 

Zero is returned if the user (group) ID is set; -1 is returned otherwise. 
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NAME V 

gethostsex - get the byte sex of the host machine 

swap_*() - swap the sex of the specified structure 

SYNOPSIS 

#include <sex,h> 
#include <filehth\h> 
#include <aouthdr.h> 
#include <scnhdr.h> 
#include <sym,h> 
#include <symcon$t.h> 
#include <cmplrs/stsupportJi> 
#include <re!oc*h> 
#include <ar.h> 

int gethostsexO 

long swap_word(word) 
long word; 

short swap__half(half) 
short half; 

void swap_filehdr (pfilehdr, destsex) 
FXLHDR *pfilehdr; 
long destsex; 

void swap__aouthdr(paouthdr, destsex) 

AOUTHDR *paouthdr; / 

long destsex; V 

void swap_scnhdr(pscnhdr, destsex) 
SCNHDR *pscnhdr; 
long destsex; 

void swap_hdr(phdr, destsex) 

pHDRRphdr; 

long destsex; 

void swapjfd(pfd, count, destsex) 
pFDRpfd; 
long count; 
long destsex; 

void swapjfi(pfi, count, destsex) 
pFITpfi; 
long count; 
long destsex; 

void swap_sym(psym, count, destsex) 
pSYMR psym; 
long count; 
long destsex; 

void swap_ext(pext, count, destsex) 
pEXTRpext; 
long count; 
long destsex; 



( 
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void swap_pd(ppd, count, destsex) 
pPDR ppd; 
long count; 
long destsex; 

void swap_dn(pdn, count, destsex) 
pRNDXR pdn; 
long count; 
long destsex; 

void swap_opt(popt, count, destsex) 
pOPTR popt; 
long count; 
long destsex; 

void swap_aux(paux, type, destsex) 
pAUXU paux; 
long type; 
long destsex; 

void swap_reloc(preloc, count, destsex) 
struct reloc *preloc; 
. long count; 
long destsex; 

void swap_ranlib(pranlib, count, destsex) 
struct ran lib *pranlib; 
long count; 
long destsex; 

DESCRIPTION 

To use these routines, the library libmld.a must be loaded. 

Gethostsex returns one of two constants BIGENDIAN or LITTLEENDIAN for the sex of the 
host machine. These constants are in sex.h. 

All swap_* routines that swap headers take a pointer to a header structure to change the byte's 
sex. The destsex argument lets the swap routines decide whether to swap bitfields before or 
after swapping the words they occur in. If destsex equals the hostsex of the machine you are 
running on, the flip happens before the swap; otherwise, the flip happens after the swap. 
Although not all routines swap structures containing bitfields, the destsex is required in the 
anticipation of future need. 

The swap_aux routine takes a pointer to an aux entry and a type , which is a ST_AUX_* con- 
stant in cmplrs/stsupport.h. The constant specifies the type of the aux entry to change the sex 
of. All other swap_* routines are passed a pointer to an array of structures and a count of 
structures to change the byte sex of. The routines swap_word and swapjialf are macros 
declared in sex.h. Only the include files necessary to describe the structures being swapped 
need be included. 

AUTHOR 

Kevin Enderby 
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NAME 

siginterrupt - allow signals to interrupt system calls 

SYNOPSIS 

siginterrupt (sig ? flag); 
int sig, flag; 

DESCRIPTION 

siginterrupt is used to change the system call restart behavior when a system call is interrupted 
by the specified signal. If the flag is false (0), then system calls will be restarted if they are 
interrupted by the specified signal and no data has been transferred yet. System call restart is 
the default behavior on 4.2 BSD. 

If the flag is true (1), then restarting of system calls is disabled. If a system call is interrupted 
by the specified signal and no data has been transferred, the system call will return -1 with 
errno set to EINTR. Interrupted system calls that have started transferring data will return the 
amount of data actually transferred. System call interrupt is the signal behavior found on 4.1 
BSD and AT&T System V UNIX systems. 

Note that the new 4.2 BSD signal handling semantics are not altered in any other way. Most 
notably, signal handlers always remain installed until explicitly changed by a subsequent 
sigvec(2) call, and the signal mask operates as documented in sigvec{2). Programs may switch 
between restartable and interruptible system call operation as often as desired in the execution 
of a program. 

Issuing a siginterrupt (3) call during the execution of a signal handler will cause the new action 
to take place on the next signal to be caught. 

NOTES 

This library routine uses an extension of the sigyec(2) system call that is not available in 
4.2BSD, hence it should not be used if backward compatibility is needed. 

RETURN VALUE 

A value indicates that the call succeeded. A -1 value indicates that an invalid signal number 
has been supplied. 

SEE ALSO 

sigvec(2), sigblock(2), sigpause(2), sigsetmask(2). 
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NAME 

signal - simplified software signal facilities 

SYNOPSIS 

#include <signahh> 

(*signal(sig 9 func))Q 
int (*func)0? 

DESCRIPTION 

signal is a simplified interface to the more general sigvec(2) facility. 

A signal is generated by some abnormal event, initiated by a user at a terminal (quit, inter- 
rupt, stop), by a program error (bus error, etc.), by request of another program (kill), or when 
a process is stopped because it wishes to access its control terminal while in the background 
(see tty (4)). Signals are optionally generated when a process resumes after being stopped, 
when the status of child processes changes, or when input is ready at the control terminal. 
Most signals cause termination of the receiving process if no action is taken; some signals 
instead cause the process receiving them to be stopped, or are simply discarded if the process 
has not requested otherwise. Except for the SIGKILL and SIGSTOP signals, the signal call 
allows signals either to be ignored or to cause an interrupt to a specified location, The follow- 
ing is a list of all signals with names as in the include file <signal.h>: 

SIGHUP 1 hangup 

SIGINT 2 interrupt 

SIGQUIT 3* quit 

SIGILL 4* illegal instruction 

SIGTRAP 5* trace trap 

SIGIOT 6* IOT instruction 

SIGEMT 7* EMT instruction 

SIGFPE 8* floating point exception 

SIGKILL 9 kill (cannot be caught or ignored) 

SIGBUS 10* bus error 

SIGSEGV 11* segmentation violation 

SIGSYS 12* bad argument to system call 

SIGPIPE 13 write on a pipe with no one to read it 

SIGALRM 14 alarm clock 

SIGTERM 15 software termination signal 

SIGURG1 16# urgent condition present on socket 

SIGSTOP 17f stop (cannot be caught or ignored) 

SIGTSTP 18f stop signal generated from keyboard 

SIGCONT 19# continue after stop 

SIGCHLD 20* child status has changed 

SIGTTIN 21f background read attempted from control terminal 

SIGTTOU 22f background write attempted to control terminal 

SIGIO 23# i/o is possible on a descriptor (see fcntl(2)) 

SIGXCPU 24 cpu time limit exceeded (see setrlimit(2)) 

SIGXFSZ 25 file size limit exceeded (see setrlimit(2)) 

SIGVTALRM 26 virtual time alarm (see setitimer(2)) 

SIGPROF 27 profiling timer alarm (see setitimer(2)) 

SIGWINCH 28# Window size change 

SIGUSR1 30 User defined signal 1 

SIGUSR2 31 User defined signal 2 
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The starred signals in the list above cause a core image if not caught or ignored. 1 

If func is SIG_DFL, the default action for signal sig is reinstated; this default is termination 
(with a core image for starred signals) except for signals marked with # or f . Signals marked 
with • are discarded if the action is SIG_DFL; signals marked with f cause the process to stop. 
If func is SIGJGN the signal is subsequently ignored and pending instances of the signal are 
discarded. Otherwise, when the signal occurs further occurrences of the signal are automati- 
cally blocked and func is called. 

A return from the function unblocks the handled signal and continues the process at the point 
it was interrupted. Unlike previous signal facilities, the handler func remains installed after a 
signal has been delivered. 

If a caught signal occurs during certain system calls, causing the call to terminate prematurely, 
the call is automatically restarted. In particular this can occur during a read or write(2) on a 
slow device (such as a terminal; but not a file) and during a wait(2). 

The value of signal is the previous (or initial) value of func for the particular signal. 

After &fork(2) or vfork(2) the child inherits all signals. execve(2) resets all caught signals to 
the default action; ignored signals remain ignored. 

RETURN VALUE 

The previous action is returned on a successful call. Otherwise, -1 is returned and errno is set 
to indicate the error. 

ERRORS 

signal will fail and no action will take place if one of the following occur: 

[EINVAL] sig is not a valid signal number. 

[EINVAL] An attempt is made to ignore or supply a handler for SIGKILL or I 

SIGSTOP. V 

[EINVAL] An attempt is made to ignore SIGCONT (by default SIGCONT is 

ignored). 

SEE ALSO 

kill(l), ptrace(2), kill(2), sigvec(2), sigblock(2), sigsetmask(2), sigpause(2), sigstack(2), 
setjmp(3), tty(4) sigreturn(2), emulate_branch(3), fpc(3), cache_Jflush(2) 
R2010 Floating Point Coprocessor Architecture Engineering Description 
R2360 Floating Point Board Product Description 

NOTES (MIPS) 

The handler routine can be declared: 

handler(sig, code, scp) 

int sig, code; 

struct sigcontext *scp; 

Here sig is the signal number. MIPS hardware exceptions are mapped to specific signals as 
defined by the table below. Code is a parameter that is either a constant as given below or 
zero, scp is a pointer to the sigcontext structure (defined in <signal.h>), that is the context at 
the time of the signal and is used to restore the context if the signal handler returns. 

The following defines the mapping of MIPS hardware exceptions to signals and codes. AH of 
these symbols are defined in either <signal.h> or <mips/cpu.h>\ 

Hardware exception Signal Code 



Integer overflow SIGFPE EXC_OV 

Segmentation violation SIGSEGV SEXC^SEGV 

Illegal Instruction SIGILL EXC_II 
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SEXC_CPU 

EXC_DBE 

EXCJBE 

EXCJRADE 

EXC_WADE 

BRKJUSERBP 

BRKJCERNELBP 

-BRKJBDJTAKEN 

BRK_JBD_JNOTTAKEN 

BREL.SSTEPBP 

BRK_OVERFLOW 

BRKJDIVZERO 

BRKJRANGE 



Coprocessor Unusable SIGILL 

Data Bus Error SIGBUS 

Instruction Bus Error SIGBUS 

Read Address Error SIGBUS 

Write Address Error SIGBUS 

User Breakpoint (used by debuggers) SIGTRAP 

Kernel Breakpoint (used by prom) SIGTRAP 

Taken Branch Delay Emulation SIGTRAP 

Not Taken Branch Delay Emulation SIGTRAP 

User Single Step (used by debuggers) SIGTRAP 

Overflow Check SIGTRAP 

Divide by Zero Check SIGTRAP 

Range Error Check SIGTRAP 

When a signal handler is reached, the program counter in the signal context structure (sc^pc) 

points at the instruction that caused the exception as modified by the branch delay bit in the 

cause register. The cause register at the time of the exception is also saved in the sigcontext 

structure (sc_jcause). If the instruction that caused the exception is at a valid user address it 

can be retrieved with the following code sequence: 

if (scp~> sccause & CAUSE_BD){ 

branch_instruction = ^(unsigned long *)($cp->$cjpc); 
exception .instruction = ^(unsigned long *)(scp->sc_pc + 4); 

} 
else 

exception Jnstruction = *(unsigned long *)(scp->sc_pc); 

Where CAUSEJD is defined in <mips/cpu.h>. 

The signal handler may fix the cause of the exception and re-execute the instruction, emulate 
the instruction and then step over it or perform some non-local goto such as a longjumpQ or 
an exit(). 

If corrective action is performed in the signal handler and the instruction that caused the 
exception would then execute without a further exception, the signal handler simply returns 
and re-executes the instruction (even when the branch delay bit is set). 

If execution is to continue after stepping over the instruction that caused the exception the 
program counter must be advanced. If the branch delay bit is set the program counter is set 
to the target of the branch else it is incremented by 4. This can be done with the following 
code sequence: 

if(scp->sc_cause & CAUSE-BD) 

emulate__branch(scp , branch_instruction) ; 
else 

scp->sc„pc +=4; 

emulateJbranchQ modifies the program counter value in the sigcontext structure to the target 
of the branch instruction. See ernulate__branch(3) for more details. 

For SIGFPE's generated by floating-point instructions (code == 0) the floating-point control and 
status register at the time of the exception is also saved in the sigcontext structure (scjpc_csr). 
This register has the information on which exceptions have occurred. When a signal handler 
is entered the register contains the value at the time of the exception but with the exceptions 
bits cleared. On a return from the signal handler the exception bits in the floating-point con- 
trol and status register are also cleared so that another SIGFPE will not occur (all other bits are 
restored from sc_fpc_csr). 
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If the floating-point unit is a R2360 (a floating-point board) and a SIGEPE is generated by the 
floating-point unit (code « 0) and program counter does not point at the instruction that 
caused the exception. In this case the instruction that caused the exception is in the floating 
point instruction exception register. The floating-point instruction exception register at the time 
of the exception is also saved in the sigcontext structure (scjpcjeir). In this case the instruc- 
tion that caused the exception can be retrieved with the following code sequence: 
union fpc_irr fpc__irr; 

fpojrr.fLword = getjfpcjrr(); 
if(sig === SIGFPE && code — && 

fpcjrr.fi-struct.implementation — IMPLEMENTATIONJR2360) 

exceptionjnstruction ■> scp->scjfpc_,eir; 

The union fpcjrr, and the constant IMPLEMENTATIONJR2360 are defined in 
<mips/fpu.h>. For the description of the routine getJpcJrrQ see/pc(3). All other floating- 
point implementations are handled in the normal manner with the instruction that caused the 
exception at the program counter as modified by the branch delay bit. 

For SIGSEGV and SIGBUS errors the faulting virtual address is saved in sejbafaaddr in the sig- 
nal context structure. 

The SIGTRAP's caused by break instructions noted in the above table and all other yet to be 
defined break instructions fill the code parameter with the first argument to the break instruc- 
tion (bits 25-16 of the instruction). 



( 
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NAME 

signal - change the action for a signal 

SYNOPSIS 

integer function signal (signum, proc, flag) 
integer sigmim, flag 
external proc 

DESCRIPTION 

When a process incurs a signal (see signal (3C)) the default action is usually to clean up and 
abort. The user may choose to write an alternative signal handling routine. A call to signal is 
the way this alternate action is specified to the system. 

Signum is the signal number (see signal (3C)). If flag is negative, then proc must be the name 
of the user signal handling routine. If flag is zero or positive, then proc is ignored and the 
value of flag is passed to the system as the signal action definition. In particular, this is how 
previously saved signal actions can be restored. Two possible values for flag have specific 
meanings: means "use the default action" (See NOTES below), 1 means "ignore this signal". 

A positive returned value is the previous action definition. A value greater than 1 is the 
address of a routine that was to have been called on occurrence of the given signal. The 
returned value can be used in subsequent calls to signal in order to restore a previous action 
definition. A negative returned value is the negation of a system error code. (See perror (3F)) 



FILES 



/usr/lib/libU77.a 



SEE ALSO 

signal(3C), kill(3F), kill(l) 

NOTES 

f77 arranges to trap certain signals when a process is started. The only way to restore the 
default 177 action is to save the returned value from the first call to signal. 

K the user signal handler is called, it will be passed the signal number as an integer argument. 
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NAME 

sin, cos, tan, asin, ' ,:os, atan, atan2 - trigonometric functions and their inverses 

SYNOPSIS 

#include <math.h> 

double sin(x) 
double x; 

float f sin (float x) 
float x; 

double cos(x) 
double x; 

float fcos (float x) 
float x; 

double tan (float x) 
double x; 

float ftan (float x) 
float x; 

double asin(x) 
double x; 

float f asm (float x) 
float x$ 

double acos(x) 
double x; 

float facos (float x) 
float x; 

double atan(x) 
double x; 

float fatan (float x) 
float x; 

double atan2(y,x) 
double y ? x; 

float fatan2 (float y,float x) 
float y,x; 

DESCRIPTION 

Sin, cos and tan return trigonometric functions of radian arguments x for double data types. 
Fsin, fcos and ftan do the same for float data types. 

Asin and fasin returns the arc sine in the range — tt/2 to 7r/2 for double and float data types 
respectively. 

Acos and facos returns the arc cosine in the range to tt for double and float data types 
respectively. 

Atan and fatan returns the arc tangent in the range -tt/2 to tt/2 for double and float data types 
respectively. 

Atan2 and fatan2 returns the arctangent of y/x in the range -tt to ?r, using the signs of both 
arguments to determine the quadrant of the return value for double and float data types 
respectively. 



MIPS Computer Systems, Inc. February 13, 1989 Page 1 



c 



( 



( 



SIN ( 3M ) RISC/os Programmer's Reference SIN ( 3M ; 



DIAGNOSTICS 

If |x| > 1 then asin(x) and acos(x) will return the default quiet NaN. 

NOTES 

Atan2 defines atan2(0,0) = 0. The reasons for assigning a value to atan2(0,0) are these: 

(1) Programs that test arguments to avoid computing atan2(0,0) must be indifferent to its 
value. Programs that require it to be invalid are vulnerable to diverse reactions to that 
invalidity on diverse computer systems. 

(2) Atan2 is used mostly to convert from rectangular (x,y) to polar (r,0) coordinates that must 
satisfy x = r*cos0 and y = r*sin0. These equations are satisfied when (x=0,y=0) is mapped 
to (r=Q,0=O). In general, conversions to polar coordinates should be computed thus: 

r := hypot(x,y); ... :» V^+y 2 ) 

:= atan2(y,x). 

(3) The foregoing formulas need not be altered to cope in a reasonable way with signed zeros 
and infinities on a machine, such as MIPS machines, that conforms to IEEE 754; the ver- 
sions of hypot and atan2 provided for such a machine are designed to handle all cases. 
That is why atan2(±0,-0) = ±tt, for instance. In general the formulas above are 
equivalent to these: 

r := V(x*x+y*y); if r = then x := copysign(l,x)^ 

if x > then :- 2*atan(y/(r+x)) f 

else := 2*atan((r-x)/y) ; 
except if r is infinite then atan2 will yield an appropriate multiple of tt/4 that would otherwise 
have to be obtained by taking limits. 

ERROR (due to Roundoff etc.) for 

Let P stand for the number stored in the computer in place of tt = 3,14159 26535 89793 23846 
26433 ... . Let "trig" stand for one of "sin", "cos" or "tan". Then the expression "trig(x)" in a 
program actually produces an approximation to trig(x*7r/P), and "atrig(x)" approximates 
(P/7r)*atrig(x). The approximations are close. 

hi the codes that run on MIPS machines, P differs from tt by a fraction of an ulp; the 
difference matters only if the argument x is huge, and even then the difference is likely to be 
swamped by the uncertainty in x. Besides, every trigonometric identity that does not involve tt 
explicitly is satisfied equally well regardless of whether P = tt. For instance, 
sin 2 (x)+cos 2 (x) = 1 and sin(2x) = 2 sin(x)cos(x) to within a few ulps no matter how big x may 
be. Therefore the difference between P and tt is most unlikely to affect scientific and engineer- 
ing computations. 

SEE ALSO 

math(3M), hypot(3M), sqrt(3M) 

AUTHOR 

Robert P. Corbett, W. Kahan, Stuart I. McDonald, Peter Tang and, for the codes for IEEE 

754, Dr. Kwok-Choi Ng. 
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NAME ^ 

sinh, cosh, tanh - hyperbolic functions 

SYNOPSIS 

#include <math.h> 

double $inh(x) 
double x; 

float fsinh (float x) 
float x; 

double cosh(x) 
double x; 

float fcosh (float x) 
float x; 

double tanh(x) 
double x; 

float ftanh(float x) 
float x; 

DESCRIPTION 

These functions compute the designated hyperbolic functions for double and float data types. 
ERROR (due to Roundoff etc.) 

Below 2.4 ulps; an ulp is one Unit in the Last Place. 

DIAGNOSTICS 

Sinh and cosh return +00 (and sink may return -00 for negative x) if the correct value would £ 

overflow. V 

SEE ALSO 

math(3M) 

AUTHOR 

W. Kahan, Kwok-Choi Ng 



( 
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NAME 

sleep - suspend execution for interval 

SYNOPSIS 

sleep (seconds) 
unsigned seconds; 

DESCRIPTION 

The current process is suspended from execution for the number of seconds specified by the 
argument. The actual suspension time may be up to 1 second less than that requested, 
because scheduled wakeups occur at fixed 1-second intervals, and an arbitrary amount longer 
because of other activity in the system. 

The routine is implemented by setting an interval timer and pausing until it occurs. The previ- 
ous state of this timer is saved and restored. If the sleep time exceeds the time to the expira- 
tion of the previous timer, the process sleeps only until the signal would have occurred, and 
the signal is sent 1 second later. 

SEE ALSO 

setitimer(2), sigpause(2), usleep(3) 
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NAME 

sleep - suspend execution for an interval 

SYNOPSIS 

subroutine sleep (itime) 

DESCRIPTION 

Sleep causes the calling process to be suspended for itime seconds. The actual time can be up 
to 1 second less than itime due to granularity in system timekeeping. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

sleep(3) 



c 



( 
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NAME 

cbrt, sqrt - cube root, square root 

SYNOPSIS 

#include <math,h> 

double cbrt(x) 
double x; 

double sqrt(x) 
double x; 

float f sqrt (float x) 
float x; 

DESCRIPTION 

Cbrt(x) returns the cube root of x. 

Sqrt(x) and f sqrt(x) returns the square root of x for double and float data types respectively. 

DIAGNOSTICS 

Sqrt returns the default quiet NaN when x is negative indicating the invalid operation. 

ERROR (due to Roundoff etc.) 

Cbrt is accurate to within 0.7 ulps. 

Sqrt on MIPS machines conforms to IEEE 754 and is correctly rounded in accordance with 
the rounding mode in force; the error is less than half an ulp in the default mode 
(round- to-nearest). An ulp is one Unit in the Last Place carried, 

SEE ALSO 

math(3M) 

AUTHOR 

W. Kahan 
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NAME 

standard - VADS standard library 

SYNOPSIS 

standard 

DESCRIPTION 

standard contains the VADS implementation of package STANDARD containing all 
predefined indentifiers in the Ada RM as well as other predefined library units. The package 
STANDARD is an imaginary package that is available to every Ada program. The package 
enables Ada programmers to use predefined types, functions, and operations on those types. 

Additional packages are available as described in the Ada RM. 

The packages in standard include all types, functions, and operations described in the Ada 
RM Annex C, Predefined Language Environment, 

FILES 

/usr/vads5/ standard/* 

SEE ALSO 

examples, publiclib, verdixlib 
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NAME 

stat, fstat - get file status 

SYNOPSIS 

integer function stat (name, statb) 
character* (*) name 
integer statb (12) 
character* (*) name 
integer statb (12) 

integer function fstat (lunit, statb) 
integer statb (12) 

DESCRIPTION 

These routines return detailed information about a file. Stat returns information about file 
name; fstat returns information about the file associated with fortran logical unit lunit. The 
order and meaning of the information returned in array statb is as described for the structure 
stat under stat (2). The "spare" values are not included. 

The value of either function will be zero if successful; an error code otherwise. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

stat(2), access(3F), perror(3F), time(3F) 

BUGS 

Pathnames can be no longer than MAXPATHLEN as defined in <sys/param.h>. 
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NAME \ 

staux - routines that provide scalar interfaces to auxiliaries 

SYNOPSIS 

#include <syms.h> 

long st_auxbtadd(bt) 
long bt; 

long st__auxbtsi;ze(iaux,width) 
long iaux; 
long width; 

long $t_auxisymadd (isym) 
long isym; 

long st_auxrndxadd (rfd,index) 
long rfd; 
long index; 

long st_auxrndxadd (idn) 
long idn; 

void st__addtq (iaux,tq) 

long iaux; 

longtq; 

long st_tqhigh_aux(iaux) 
long iaux; 

void st_shifttq (iaux, tq) g~ 

int iaux; I 

int tq; 

long st_iauxL_copyty (ifd, psym) 
long ifd; 
pSYMR psym; 

void st_changeaux (iaux, aux) 
long iaux; 
AUXU aux; 

void st_changeauxrodx (iaux, rfd, index) 
long iaux; 
long rfd; 
long index; 

DESCRIPTION 

Auxiliary entries are unions with a fixed length of four bytes per entry. Much information is 
packed within the auxiliaries. Rather than have the compiler front-ends handle each type of 
auxiliary entry directly, the following set of routines provide a high-level scalar interface to the 
auxiliaries: 

st_auxbtadd 

Adds a type information record (TIR) to the auxiliaries. It sets the basic type (bt) to 
the argument and all other fields to zero, The index to this auxiliary entry is returned. 

st^auxbtsize 

Sets the bit in the TIR, pointed to by the iaux argument. This argument says the basic 
type is a bit field and adds an auxiliary with its width in bits. 

st_auxisymadd § 
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Adds an index into the symbol table (or any other scalar) to the auxiliaries. It sets the 
value to the argument that will occupy all four bytes. The index to this auxiliary entry 
is returned. 

st_auxrndxadd 

Adds a relative index, RNDXR, to the auxiliaries. It sets the rfd and index to their 
respective arguments. The index to this auxiliary entry is returned. 

st_auxrndxaddjdn 

Works the same as stuauxrndxadd except that RNDXR is referenced by an index into 
the dense number table. 

stjauxjcopyty 

Copies the type from the specified file (ifd) for the specified symbol into the auxiliary 
table for the current file. It returns the index to the new aux. 

stjshifttq 

Shifts in the specified type qualifier, tq, into the auxiliary entry TIR, which is specified 
by the 'iaux' index into the current file. The current type qualifiers shift up one tq so 
that the first tq (tqO) is free for the new eij.trv, 

st_addtq 

Adds a type qualifier in the highest or most s nificant non4qNil type qualifier. 

stjqhighjaux 

Returns the most significant type qualifier given an index into the files aux table. 

stjchangeaux 

Changes the iauxth aux in the current file's auxiliary table to aux. 

stjzhangeauxmdx 

Converts the relative index (RNDXR) auxiliary, which is specified by iaux, to the 
specified arguments. 

AUTHOR Mark I. Himelstein 
SEE ALSO 

stfd(3) 

BUGS 

The interface will added to incrementally, as needed. 
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NAME ^ 

stcu - routines that provide a compilation unit symbol table interface 

SYNOPSIS 

#include <syms.h> 

pCHDRR st_euinit 

void st_setchdr (pchdr) 
pCHDRR pchdr; 

pCHDRR sLcurrentpchdrQ 

void st_freeO 

long st_extadd (i$s 9 value, si, $c, index) 

long iss; 

long value; 

long st; 

long sc; 

long index; 

pEXTR st_pext_jext (iext) 
long iext; 

pEXTR st_pext_rndx (rndx) 
RNDXRrndx; 

long stjextmaxQ 

long st_ext$tradd (str) 

char *str; £ 

char *st_str_extiss (iss) ^ 

long iss; 

long st_jdn_index_Jext (index, fext) 
long index; 
long fext; 

long st_jdn_rndx (rndx) 
RNDXRrndx; 

pRNDXR st_pdn_jdn (idn) 
long idn; 

RNDXR sUmdx_idn (idn) 
long idn; 

void st_setidn (idndest, idnsrc) 
long idndest; 
long idnsrc; 

DESCRIPTION 

The stcu routines provide an interface to objects that occur once per object rather than once 
per file descriptor (for example, external symbols, strings, and dense numbers). The routines 
provide access to the current chdr (compile time hdr), which represents the symbol table in 
running processes with pointers to symbol table sections rather than indices and offsets used 
in the disk file representation, 

A new symbol table can be created with st_cuinit. This routine creates and initializes a 
CHDRR. The CHDRR is the current chdr and is used in all later calls. NOTE: A chdr can 
also be created with the read routines (see stio(3)). The stjzuinit routine returns a pointer to 
the new CHDRR record. 
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stjcurrentchdr 

Returns a pointer the current chdr. 

stjsetchdr 

Sets the current chdr to the pchdr argument and sets the per file structures to reflect a 
change in symbol tables. 

stjree Frees all constituent structures associated with the current chdr. 

st^extadd 

Lets you add to the externals table. It returns the index to the new external for future 
reference and use. The ifd field for the external is filled in by the current file (see 

$t_pext_iext 

and st_pext_rndx 

Returns pointers to the external, given a index referencing them. The latter routine 
requires a relative index where the index field should be the index in external symbols 
and the rfd field should be the constant ST_EXTIFD. NOTE: The externals contain 
the same structure as symbols (see the SYMR and EXTR definitions). 

stjextmax 

Returns the current number of entries in the external symbol table. 

The iss field in external symbols (the index into string, space) must point into external string 
space. 

stjdxtstradd 

Adds a null-terminated string to the external string space and returns its index. 

stjstr_extiss 

Converts that index into a pointer to the external string. 

The dense number table provides a convenience to the code optimizer, generator, and assem- 
bler. This table lets them reference symbols from different files and externals with unique 
densely packed numbers. 

stjdn_index_fext 

Returns a new dense number table index, given an index into the symbol table of the 
current file (or iifext is set, the externals table). 

stjdnjrndx 

Returns a new dense number, but expects a RNDXR to specify both the file index 
and the symbol index rather than implying the file index from the current file. The 
RNDXR contains two fields: an index into the externals table and a file index (rsyms 
can point into the symbol table, as well). The file index is SXJEXTIFD for externals. 

stjrndxjdn 

Returns a RNDX, given an index into the dense number table. 

st_pdnjdn 

Returns a pointer to the RNDXR index by the 'idn' argument. 

AUTHOR Mark I. Himelstein 
SEE ALSO 

stfe(3), stfd(3) 
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NAME ^ 

stfd - routines that provide access to per file descriptor section of the symbol table 

SYNOPSIS 

#include <symsJi> 

long st_currentifd 

long st_jfdmax 

void st_setfd (ifd) 
long ifd; 

long stjfdadd (filename) 
char *filename; 

long st__symadd (iss, value, st, sc, freloc, index) 

long iss; 

long value; 

long st; 

long sc; 

long freloc; 

long index; 

long st_auxadd (aux) 

AUXUaux; 

long st_$tradd (cp) 
char *cp; 

long stjineadd (line) g- 

long line; I 

long st_pdadd (isym) 
long isym; 

long st_ifd_pcfd (pcfdl) 
pCFDRpcfdl; 

pCFDR st_pcfd_ifd (ifd) 
long ifd; 

pSYMR st_psymjfdjsym (ifd, isym) 
long ifd; 
long isym; 

pAUXU st_paux_ifd„iaux (ifd, iaux) 
long ifd; 
long iaux; 

pAUXU st_paux_jaux (iaux) 
long iaux; 

char *st_str_iss (iss) 
long iss; 

char *st_str_ifd_iss (ifd, iss) 
long ifd; 
long iss; 

pPDR st_ppd_jfd_Jsym (ifd, isym) 

long ifd; 

long isym; i 
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NAME 

stdio - standard buffered input/output package 

SYNOPSIS 

#include <stdio.h> 

FILE *stdin; 
FILE *stdout; 
FILE *stderr; 

DESCRIPTION 

The functions described in section 3S constitute a user-level buffering scheme. The in-line 
macros g<ttc and putc (3S) handle characters quickly. The higher level routines gets, fgets, 
scanf, f scanf, fread, puts, fputs, printf, fprintf, fwrite all use getc and putc; they can be freely 
intermixed. 

A file with associated buffering is called a stream, and is declared to be a pointer to a defined 
type FILE. fopen(3S) creates certain descriptive data for a stream and returns a pointer to 
designate the stream in all further transactions. There are three normally open streams with 
constant pointers declared in the include file and associated with the standard open files: 

stdin standard input file 

stdout standard output file 

stderr standard error file 

A constant 'pointer' NULL (0) designates no stream at all. 

An integer constant EOF (-1) is returned upon end of file or error by integer functions that 
deal with streams. 

Any routine that uses the standard input/output package must include the header file 
<stdioM> of pertinent macro definitions. The functions and constants mentioned in sections 
labeled 3S are declared in the include file and need no further declaration. The constants, 
and the following 'functions' are implemented as macros; redeclaration of these names is peri- 
lous: getc , getchar, putc , putchar, feof, /error, fileno . 

SEE ALSO 

open(2), close(2), read(2), write(2), fread(3S), fseek(3S), f*(3S) 

DIAGNOSTICS 

The value EOF is returned uniformly to indicate that a FILE pointer has not been initialized 
with j 'open, input (output) has been attempted on an output (input) stream, or a FILE pointer 
designates corrupt or otherwise unintelligible FILE data. 

For purposes of efficiency, this implementation of the standard library has been changed to 
line buffer output to a terminal by default and attempts to do this transparently by flushing the 
output whenever a read(2) from the standard input is necessary. This is almost always tran- 
sparent, but may cause confusion or malfunctioning of programs which use standard i/o rou- 
tines but use read (2) themselves to read from the standard input. 

In cases where a large amount of computation is done after printing part of a line on an out- 
put terminal, it is necessary to fflush(3S) the standard output before going off and computing 
so that the output will appear. 

BUGS 

The standard buffered functions do not interact well with certain other library and system 
functions, especially vfork and abort. 

LIST OF FUNCTIONS 

Name Appears on Page Description 

clearerr ferror.3s stream status inquiries 
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NAME 

stfd - routines that provide access to per file descriptor section of the symbol table 

SYNOPSIS 

#include <syms.h> 

long st_cuirentifd 

long st_ifdmax 

void st_setfd (ifd) 
long ifd; 

long st_fdadd (filename) 
char ^filename; 

long st_symadd (iss, value, st, sc, freloc, index) 

long iss; 

long value; 

long st; 

long sc; 

long freloc; 

long index; 

long st_auxadd (aux) 
AUXU aux; 

long st_stradd (cp) 
char *cp; 

long stjineadd (line) 
long line; 

long st„pdadd (isym) 
long isym; 

long st_ifd_pcfd (pcfdl) 
pCFDR pcfdl; 

pCFDR st_pcfd„ifd (ifd) 
long ifd; 

pSYMR st_psym_ifd_isym (ifd, isym) 
long ifd; 
long isym; 

pAUXU st_pauxjfd_iaux (ifd, iaux) 
long ifd; 
long iaux; 

pAUXU st_paux_iaux (iaux) 
long iaux; 

char *st_str_iss (iss) 
long iss; 

char *st_str_ifd_iss (ifd, iss) 
long ifd; 
long iss; 

pPDR st_ppd_ifd_isym (ifd, isym) 
long ifd; 
long isym; 
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char * st_malloc (ptr, psize, itemsize, baseitems) 
char *ptr; 
long *size; 
long itemsize; 
long baseitems; 



AUTHOR Mark I, Himelstein 
SEE ALSO 

stfe(3), stcu(3). 



( 



DESCRIPTION 

The stfd routines provide an interface to objects handled on a per file descriptor (or fd) level 
(for example, local symbols, auxiliaries, local strings, line numbers, optimization entries, pro- 
cedure descriptor entries, and the file descriptors). These routines constitute a group because 
they deal with objects corresponding to fields in the FDR structure. 

A fd can be activated by reading an existing one into memory or by creating a new one. The 
compilation unit routines st^readbinary and stjreadst read file descriptors and their constituent 
parts into memory from a symbol table on disk. 

Stjdadd adds a file descriptor to the list of file descriptors. The tang field is initialized from a 
user specified global stjang that should be set to a constant designated for the language in 
symconst.h. The f Merge field is initialized from the user specified global st_merge that specifies 
whether the file is to start with the attribute of being able to be merged with identical files at 
load time. The fBigendian field is initialized by the gethostsex(S) routine, which determines the 
permanent byte ordering for the auxiliary and line number entries for this file. 
St Jdadd adds the null string to the new files string table that is accessible by the constant 
issNull (0). It also adds the filename to the string table and sets the rss field. Finally, the 
current file is set to the newly added file so that later calls operate on that file. 
All routines for fd4evel objects handle only the current file unless a file index is specified. The 
current file can also be set with stjsetfd. | 

Programs can find the current file by calling stjcurrentifd, which returns the current index. Pro- 
grams can find the number of files by calling stjfdmax. The fd routines only require working 
with indices to do most things. They allow more in-depth manipulation by allowing users to 
get the compile time file descriptor (CFDR) that contains memory pointers to the per file 
tables (rather than indices or offsets used in disk files). Users can retrieve a pointer to the 
CFDR by calling st-pcfdjfd with the index to the desired file. The inverse mapping stjfd^pcfd 
exists, as well. 

Each of fd's constituent parts has an add routine: stjsymadd, st_stradd, stjineadd, $t_pdadd, 
and st_auxadd. The parameters of the add routines correspond to the fields of the added 
object. The pdadd routine lets users fill in the isym field only. Further information can be 
added by directly accessing the procedure descriptor entry. 

The add routines return an index that can be used to retrieve a pointer to part of the desired 
object with one of the following routines: st^psymjsyrn, stjstrjss, and stjpauxJaux. NOTE; 
These routines only return objects within the current file. The following routines allow for file 
specification: st^psymjfdjsym, st_auxjfdjaux, and stjstrjfdjss. 

St_ppdJfdJsym allows access to procedures through the file index for the file where they 
occur and the isym field of the entry that points at the local symbol for that procedure. 

The return index from stjsymadd should be used to get a dense number (see stcu(3)). That 
number should be the ucode block number for the object the symbol describes. 



( 
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BUGS 

The interface will added to incrementally, as needed. 
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NAME \ 

stfe - routines that provide a high-level interface to basic functions needed to access and add 
to the symbol table 

SYNOPSIS ■ 

#include <syms.h> 

long st_fllebegin (filename, lang, merge, glevel) 

char *filename; 

longlang; 

long merge; 

long glevel; 

long st_endallfiles 

long st_fileend (idn) 
long idn; 

long st_blockbegin(iss, value, sc) 
long iss; 
long value; 
long sc; 

long st_textblockO 

long st-blockend(size) 
long size; 

long $t_procend(idn) 

long idn ^~ 

long st_procbegin (idn) 1 

long idn; 

char *st_str_jdn (idn) 
long idn; 

char *st_sym_idn (idn, value, sc, st, index) 

long idn; 

long *value; 

long *sc; 

long *st; 

long *index; 

long st_abs_jfd_index (ifd, index) 
long ifd; 
long index; 

long stjfglobaljdn (idn) 
long idn; 

pSYMR st_psym_idn_offset (idn, offset) 
long idn; 
long offset; 

long st_pdadd_jdn (idn) 
long idn; 

DESCRIPTION 

The stfe routines provide a high-level interface to the symbol table based on common needs of 



the compiler front-ends. 
st_filebegin 
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should be called upon encountering each cpp directive in the front end. It calls 
st_fdeadd to add symbols and will find the appropriate open file or start a new file. It 
takes a filename, language constant (see syrnconst.h), a merge flag (0 or 1) and the -g 
level constant (see syrnconst.h). It returns a dense number pointing to the file symbol 
to be used in line number directives. 

stjileend 

Requires the dense number from the corresponding st_filebegin call for the file in 
question. It then generates an end symbol and patches the references so that the 
index field of the begin file points to that of one beyond the end file. The end file 
points to the begin file. 

$t_endallfiles 

Is called at the end of execution to close off all files that haven't been ended by previ- 
ous calls to stjilebegin. CPP directives might not reflect the return to the original 
source file; therefore, this routine can possibly close many files. 

stjblockbegin 

Supports both language blocks (for example, C's left curly brace blocks), beginning 
of structures, and unions. If the storage class is scText, it is the former; if it is sclnfo, 
it is one of the latter. The iss (index into string space) specifies the name of the 
structure/etc, if any. 

If the storage class is scText, we must check the result of stjblockbegin. It returns a dense 
number for outer blocks and a zero for nested blocks. The non-zero block number should be 
used in the BGNB ucode. Users of languages without nested blocks that provide variable 
declarations can ignore the rest of this paragraph. Nested blocks are two-staged: one stage 
happens when we detect the language block and the other stage happens when we know the 
block has content. If the block has content (for example, local variables), the front-end must 
call stjextblock to get a non-zero dense number for the block's BGNB ucode. If the block has 
no content and stjextblock is not called, the block's stjblockbegin and stjblockend do not 
produce block and end symbols. 

If it is sclnfo, stjblockbegin creates a begin block symbol in the symbol table and returns a 
dense number referencing it. The dense number is necessary to build the auxiliary required to 
reference the structure/ etc. It goes in the aux after the TIR along with a file index. This dense 
number is also noted in a stack of blocks used by st_blockend. 

Stjblockbegin should not be called for language blocks when the front-end is not producing 
debugging symbols. 

Stjblockend requires that blocks occur in a nested fashion. It retrieves the dense number for 
the most recently started block and creates a corresponding end symbol. As in fileend, both 
the begin and end symbol index fields point at the other end's symbol. If the symbol ends a 
structure/etc, as determined by the storage class of the begin symbol, the size parameter is 
assigned to the begin symbol's value field. It's usually the size of the structure or max value of 
a enum. We only know it at this point. The dense number of the end symbol is returned so 
that the ucode ENDB can be use it. If it is an ignored text block, the dense number is zero 
and no ENDB should be generated. 

In general, defined external procedures or functions appear in the symbols table and the exter- 
nals table. The external table definition must occur first through the use of a st_extadd. After 
that definition, stjprocbegin can be called with a dense number referring to the external sym- 
bol for that procedure. It checks to be sure we have a defined procedure (by checking the 
storage class). It adds a procedure symbol to the symbol table. The external's index should 
point at its auxiliary data type information (or if debugging is off, indexNil), This index is 
copied into the regular symbol's index field or a copy of its type is generated (if the external is 
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in a different file than the regular symbol). Next, we put the index to symbol in the external's \ 

index field. The external's dense number is used as a block number in ucodes referencing it 
and is used to add a procedure when in the st__pdaddjdn, 

st^rocend 

Creates an end symbol and fixes the indices as in blockend and fileend, except that 
the end procedure reference is kept in the begin procedure's aux rather than in the 
index field (because the begin procedure has a type as well as an end reference). This 
must be called with the dense number of the procedure's external symbol as an argu- 
ment and returns the dense number of the end symbol to be used in the END ucode. 

st_jStrJdn 

Returns the string associated with symbol or external referenced by the dense number 
argument. If the symbol was anonymous (for example, there was no symbol) a (char 
*), -1 is returned. 

st^.sym_idn 

Returns the same result as stjstrjdn, except that the rest of the fields of the symbol 
specified by the idn are returned in the arguments. 

st_fglobalJdn 

Returns a 1 if the symbol associated with the specified idn is non-static; otherwise, a 
is returned, 

st^absjfdjhdex 

Returns the absolute offset for a dense number, If the symbol is global, the global's 
index is returned. If the symbol occurred in a file, the sum of all symbols in files 
occurring before that file and the symbol's index within the file is returned. 

stjpdaddjdn I 

Adds an entry to the procedure table for the stjpwc entry generated by procbegin. 
This should be called when the front-end generates code for the procedure in ques- 
tion. 

AUTHOR Mark I. Himelstein 
SEE ALSO 

stcu(3), stfd(3) 
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NAME 

stio - routines that provide a binary read/write interface to the MIPS symbol table 

SYNOPSIS 

#include <syms.h> 

long st_readbinary (filename, how) 
char *filename; 
char how; 

long st__readst (fn, how, filebase, pchdr, flags) 

long fn; 

char how; 

long filebase; 

pCHDRR pchdr; 

long flags; 

void st„writebinary (filename, flags) 
char ^filename; 
long flags; 

void st_writest (fn, flags) 
long fn; 
long flags; 

DESCRIPTION 

The CHDRR structure (see stcu(3)) represents a symbol table in memory. A new CHDRR 
can be created by reading a symbol table in from disk. St_readbinary and stjreadst read a 
symbol table in from disk. 

Stjeadbinary takes the file name of the symbol table and assumes the symbol table header 
HDRR occurs at the beginning of the file. Stjreadst assumes that its file number references a 
file positioned at the beginning of the symbol table header and that the filebase parameter 
specifies where the object or symbol table file is based (for example, non-zero for archives). 

The second parameter to the read routines can be V for read only or 'a' for appending to the 
symbol table. Existing local symbol, line, procedure, auxiliary, optimization, and local string 
tables can not be appended. If they didn't exist on disk, they can be created. This restriction 
stems from the allocation algorithm for those symbol table sections when read in from disk 
and follows the standard pattern for building the symbol table. 

The symbol table can be read incrementally. If pchdr is zero, stjreadst assumes that no sym- 
bol table has been read yet; therefore, it reads in the symbol table header and file descriptors. 
The flags argument is a bit mask that defines what other tables should be read. St_p* constants 
for each table can be ORed. If flags equals '-I', all tables are read. If pchdr is set, the tables 
specified by flags are added to the tables that have already been read. The value of pchdr can 
be gotten from stjcurrentjpchdr (see stcu(3)). 

Line number entries are encoded on disk, and the read routines expand them to longs. See 
the MIPS System Programmer Guide. 

If the version stamp is out of date, a warning message is issued to stderr. If the magic number 
in the HDRR is incorrect, st_error is called. All other errors cause the read routines to read 
non-zero; otherwise, a zero is returned. 

Stjvritebinary and stjvritest are symmetric to the read routines, excluding the how and pchdr 
parameters. The flags parameter is a bit mask that defines what table should be written. St^p* 
constants for each table can be ORed. If flags equals '-!', all tables are written. 
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The write routines write sections of the table in the approved order, as specified hj the link 
editor (Id) specification. 

Line numbers are compressed on disk. See the MIPS System Programmer Guide, 

The write routines start all sections of the symbol table on four-byte boundaries. 

If the write routines encounter an error, stjerror is called. After writing the symbol table, 
further access to the table by other routines is undefined. 

AUTHOR Mark I. Himelstem 
SEE ALSO 

stcu(3),stfe(3), stfd(3). 

The MIPS System Programmer Guide, 
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NAME 

stprint - routines to print the symbol table 

SYNOPSIS 

#in elude <syms,h> 

#include <stdio.h> 

char *st_jnlang_ascii []; 

char *st_mst_ascii []; 

char *st_msc__ascii Q; 

char *st_jmtbt_ascii D; 

char *st_jntq_ascii □; 

void st_dump (fd, flags) 
FILE *fd; 
long flags; 

void st_printfd (fd, ifd, flags) 
FILE *fd; 
long ifd; 
long flags; 

DESCRIPTION 

The stprint routines and arrays provide an easy way to print the MIPS symbol table. The print 
the symbol table from st_current pchdr(). 

The arrays map constants to their ASCII equivalents. The constants can be found in 
symconst.h and represent languages (lang), symbol types ($t) 9 storage classes (sc), basic types 
(bt), and type qualifiers (tq). 

The st_dump routine prints an ASCII version of the symbol. If fd is NULL, the routine prints 
file fd and stdout. The flags can be a mask of a section of symbol table specified by ORing 
STJP* constants together from cmplrs/stsupport.h. This routine modifies the current file. 

st^printfd prints the sections associated with the file specified by the ifd argument. The other 
arguments are the same as in st_dump. These arguments modify the current file, as well. 

AUTHOR Mark I. Himelstein 
SEE ALSO 

stfe(3), stcu(3), sym.h(5), stsupport.h(S) 

ERRORS 

The interface will be added to incrementally as needed. 
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NAME \ 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, index, strchr, rindex, strrchr, strpbrk, 
strspn, strcspn, strtok - string operations 

SYNOPSIS 

#include <string,h> 

char *strcat (si, s2) 
char *sl, *s2; 

char *strncat (si, s2, n) 
char *sl, *s2; 
int n; 

int strcmp (si, s2) 
char *sl, *s2; 

int strncmp (si, s2, n) 
char *sl, *s2; 
int n; 

char *strcpy (si, s2) 
char *sl, *s2; 

char *strncpy (si, &2, n) 
char *sl, *s2; 
int n; 

int strlen (s) 

char *s; 

char *index (s, $) I 

charts; 

int c; 

char *strchr (s, c) 
char *$; 
int c; 

char *rindex (s, c) 

charts; 
int c; 

char *strrchr (s, c) 

char *s; 
int c; 

char *strpbrk (si, $2) 
char *sl, *s2; 

int strspn (si, s2) 
char *sl, *$2; 

int strcspn (si, s2) 
char *sl, *s2; 

char *strtok (si, $2) 
char *sl, *s2; 

DESCRIPTION 

The arguments si, $2 and s point to strings (arrays of characters terminated by a null charac- 



ter). The functions strcat, strncat, strcpy, and strncpy all alter si. These functions do not 
check for overflow of the array pointed to by si. 
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strcat appends a copy of string s2 to the end of string si. strncat appends at most n charac- 
ters. Each returns a pointer to the null-terminated result. 

strcmp compares its arguments and returns an integer less than, equal to, or greater than 0, 
according as si is lexicographically less than, equal to, or greater than s2. strncmp makes the 
same comparison but looks at at most n characters. 

strcpy copies string s2 to si, stopping after the null character has been copied, strncpy copies 
exactly n characters, truncating s2 or adding null characters to si if necessary. The result will 
not be null-terminated if the length of s2 is n or more. Each function returns si. 
strlen returns the number of characters in s, not including the terminating null character. 

Index {rindex) returns a pointer to the first (last) occurrence of character c in string s, or a 
NULL pointer if c does not occur in the string. The null character terminating a string is con- 
sidered to be part of the string. The routines strchr and strrchr are, respectively, different 
names for the index and rindex. 

strpbrk returns a pointer to the first occurrence in string si of any character from string s2, or 
a NULL pointer if no character from s2 exists in si . 

strspn (strcspn) returns the length of the initial segment of string si which consists entirely of 
characters from (not from) string s2. 

strtok considers the string si to consist of a sequence of zero or more text tokens separated by 
spans of one or more characters from the separator string s2. The first call (with pointer si 
specified) returns a pointer to the first character of the first token, and will have written a null 
character into si immediately following the returned token. The function keeps track of its 
position in the string between separate calls, so that subsequent calls (which must be made 
with the first argument a NULL pointer) will work through the string si immediately following 
that token. In this way subsequent calls will work through the string si until no tokens 
remain. The separator string s2 may be different from call to call. When no token remains in 
si , a NULL pointer is returned. 



NOTE 



For user convenience, all these functions are declared in the optional <string.h> header file. 



ERRORS 

strcmp and strncmp use native character comparison, which is signed on PDP-lls and VAX-lls, 
unsigned on other machines. Thus the sign of the value returned when one of the characters 
has its high-order bit set is implementation-dependent. 

Character movement is performed differently in different implementations. Thus overlapping 
moves may yield surprises. 
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NAME 

stty, gtty - set and get terminal state (defunct) 

SYNOPSIS 

#include <sgtty*h> 

stty(fd, buf) 

int fd; 

struct sgttyb *buf; 

gtty(fd, buf) 

int fd; 

struct sgttyb *buf; 

DESCRIPTION 

This interface is obsoleted by ioctl(2). 

stty sets the state of the terminal associated with fd. gtty retrieves the state of the terminal 
associated with/d. To set the state of a terminal the call must have write permission. 

The stty call is actually "ioctl(fd, TIOCSETP, buf)", while the- gtty call js "ioctl(fd, TIOCGETP, 
buf)". See ioctl(2) and fly (4) for an explanation. 

DIAGNOSTICS 

If the call is successful is returned, otherwise -1 is returned and the global variable errno 
contains the reason for the failure. 

SEE ALSO 

ioctl(2), tty(4) 
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NAME 

swab - swap bytes 

SYNOPSIS 

swab(from, to, nbytes) 
char *from, *to; 

DESCRIPTION 

swab copies nbytes bytes pointed to by from to the position pointed to by to, exchanging adja- 
cent even and odd bytes. It is useful for carrying binary data between PPPll's and other 
machines, nbytes should be even. 
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NAME 

syslog, openlog, closelog, setlogmask - control system log 

SYNOPSIS 

#include <syslog.h> 

openlog (ident, logopt, facility) 
char *ident; 

syslog (priority, message, parameters — ) 
char *message; 

closelog 
setlogmask (maskpri) 

DESCRIPTION 

syslog arranges to write message onto the system log maintained by syslogd (8). The message is 
tagged with priority. The message looks like a printf(3) string except that %m is rcplz ;cd by 
the current error message (collected from errno). A trailing newline is added if needed. This 
message will be read by syslogd(8) and written to the system console, log files, or forwarded to 
syslogd on another host as appropriate. 

Priorities are encoded as a facility and a level. The facility describes the part of the system 
generating the message. The level is selected from an ordered list: 



LOG_EMERG 
LOG_ALERT 

LOG_CRIT 
LOGJERR 
LOGJWARNING 
LOG_NOTICE 



A panic condition. This is normally broadcast to all users, 

A condition that should be corrected immediately, such as a corrupted 
system database. 

Critical conditions, e.g., hard device errors. 

Errors. 

Warning messages. 

Conditions that are not error conditions, but should possibly be handled 



specially. 

LOG_INFO Informational messages. 

LOGJDEBUG Messages that contain information normally of use only when debugging 

a program. 

If syslog cannot pass the message to syslogd, it will attempt to write the message on 
/dev I console if the LOG^CONS option is set (see below). 

If special processing is needed, openlog can be called to initialize the log file. The parameter 
ident is a string that is prepended to every message, logopt is a bit field indicating logging 
options. Current values for logopt are: 

LOGPID log the process id with each message: useful for identifying instantiations 

of daemons. 

Force writing messages to the console if unable to send it to syslogd. 
This option is safe to use in daemon processes that have no controlling 
terminal since syslog will fork before opening the console. 

Open the connection to syslogd immediately. Normally the open is 
delayed until the first message is logged. Useful for programs that need 
to manage the order in which file descriptors are allocated. 

Don't wait for children forked to log messages on the console. This 
option should be used by processes that enable notification of child ter- 
mination via SIGCHLD, as syslog may otherwise block waiting for a child 



LOG_CONS 



LOG_NDELAY 



LOG_NOWAIT 



( 
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whose exit status has already been collected. 

The facility parameter encodes a default facility to be assigned to all messages that do not 
have an explicit facility encoded: 

LOG_KERN Messages generated by the kernel. These cannot be generated by any 

user processes. 

LOGJUSER Messages generated by random user processes. This is the default facil- 

ity identifier if none is specified. 

LOGJVIAIL The mail system. 

LOG_DAEMON System daemons, such &sftpd(8), routed(8), etc. 

LOG_AUTH The authorization system: login(l), su(l), getty(8), etc. 

LOGJLPR The line printer spooling system: lpr(\), lpc(8), lpd(8), etc. 

LQGJLOCALO Reserved for local use. Similarly for LOGJLOCAL1 through 

LOGJLOCAL7. 

closelog can be used to close the log file. 

setlogmask sets the log priority mask to maskpri and returns the previous mask. Calls to syslog 
with a priority not set in maskpri are rejected. The mask for an individual priority pri is calcu- 
lated by the macro LOG_MASK(pn); the mask for all priorities up to and including toppri is 
given by the macro LOGJJPTO(top/?n). The default allows all priorities to be logged. 

EXAMPLES 

syslog(LOG__ALERT, "who: internal error 23"); 

openlog("ftpd", LOGPID, LOGJDAEMON); 

setlogmask (LOGJJPTO(LOGJERR)) ; 

syslog(LOG_INFO, "Connection from host %d", CallingHost); 

syslog(-lLOGJNFO|LOGJLOCAL2, "foobar error: %m"); 

SEE ALSO 

logger(l), syslogd(8) 
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NAME 

system - issue a shell command 

SYNOPSIS 

system (string) 
char *string; 

DESCRIPTION 

system causes the string to be given to sh (1) as input .as if the string had been typed as a com- 
mand at a terminal, The current process waits until the shell has completed, then returns the 
exit status of the shell. 

SEE ALSO 

popen(3S), execve(2), wait(2) 

DIAGNOSTICS 

Exit status 127 indicates the shell couldn't be executed. 



( 
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NAME 

system - execute a UNIX command 

SYNOPSIS 

integer function system (string) 
character* (*) string 

DESCRIPTION 

System causes string to be given to your shell as input as if the string had been typed as a com- 
mand. If environment variable SHELL is found, its value will be used as the command inter- 
preter (shell); otherwise sh(l) is used. 

The current process waits until the command terminates. The returned value will be the exit 
status of the shell. See wait(2) for an explanation of this value. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

exec(2), wait(2), system(3) 

BUGS 

String can not be longer than NCARGS-50 characters, as defined in <syslparam.h> . 
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NAME 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal independent operation routines 

SYNOPSIS 

char PC; 
char *BC; 
char *UP; 
short ©speed; 

tgetent(fop 9 name) 
char *bp 9 *name; 

tgetnum (id) 
char *id; 

tgetflag (id) 

char *id; 

char * 
tgetstr(id 9 area) 

char *i& 9 **area; 

char * 

tgoto(cm, destco! ? destiine) 

char *cm; 

tputs (cp, affcnt, outc) 
register char *cp; 
int affcnt; 
int (*outc)0? 

DESCRIPTION 

These functions extract and use capabilities from the terminal capability data base termcap(5). 
These are low level routines; see curses (3X) for a higher level package. 

tgetent extracts the entry for terminal name into the buffer at hp. Bp should be a character 
buffer of size 4096 and must be retained through all subsequent calls to tgetnum, tgetflag, and 
tgetstr. tgetent returns -1 if it cannot open the terrncap file, if the terminal name given does 
not have an entry, and 1 if all goes well. It will look in the environment for a TERMCAP vari- 
able. If found, and the value does not begin with a slash, and the terminal type name is the 
same as the environment string TERM, the TERMCAP string is used instead of reading the 
terrncap file. If it does begin with a slash, the string is used as a path name rather than 
/etc/terrncap. This can speed up entry into programs that call tgetent, as well as to help debug 
new terminal descriptions or to make one for your terminal if you can't write the file 
/etc/ terrncap. 

tgetnum gets the numeric value of capability id, returning -1 if is not given for the terminal. 
tgetflag returns 1 if the specified capability is present in the terminal's entry, if it is not. 
tgetstr returns the string value of the capability id, places it in the buffer at area, and advances 
the area pointer. It decodes the abbreviations for this field described in terrncap (5), except 
for cursor addressing and padding information, tgetstr returns NULL if the capability was not 
found, 

tgoto returns a cursor addressing string decoded from cm to go to column destcol in line dest* 
line. It uses the external variables UP (from the up capability) and BC (if he is given rather 
than bs) if necessary to avoid placing \n, D or "@ in the returned string. (Programs which 
call tgoto should be sure to turn off the XTABS bit(s), since tgoto may now output a tab. 
Note that programs using terrncap should in general turn off XTABS anyway since some termi- 
nals use control I for other functions, such as nondestructive space.) If a % sequence is given 
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which is not understood, then tgoto returns "OOPS". 

tputs decodes the leading padding information of the string cp; affcnt gives the number of lines 
affected by the operation, or 1 if this is not applicable, outc is a routine which is called with 
each character in turn. The external variable ospeed should contain the output speed of the 
terminal as encoded by $tty(3). The external variable PC should contain a pad character to be 
used (from the pc capability) if a null ("@) is inappropriate. 



FILES 



/usr/lib/libtermcap.a -ltermcap library 
/etc/termcap data base 

SEE ALSO 

ex(l), curses(3X), termcap(5) 

AUTHOR 

William Joy 
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NAME I 

time, ftime - get date and time 

SYNOPSIS 

long time(O) 

long time(tloc) 
long *tloc; 

#include <sys/types.h> 
#include <sy$/timefo.h> 
ftime (tp) 
struct timeb *tp; 

DESCRIPTION 

These interfaces are obsoleted by gettimeofday(2). 

time returns the time since 00:00:00 GMT ? Jan. 1, 1970, measured in seconds. 

If tloc is nonnull, the return value is also stored in the place to which tloc points. 

The ftime entry fills in a structure pointed to by its argument, as defined by <sy$/timeb.h>: 

/* 

* Copyright (c) 1982, 1986 Regents of the University of California. 

* All rights reserved. The Berkeley software License Agreement 

* specifies the terms and conditions fur redistribution. 
* 

* @(#)timeb.h7.1 (Berkeley) 6/4/86 
*/ 

/* V 

* Structure returned by ftime system call 

*/ 
struct timeb 

{ 

time_t time; 
unsigned short millitm; 
short timezone; 
short dstflag; 

}; 

The structure contains the time since the epoch in seconds, up to 1000 milliseconds of more- 
precise interval, the local time zone (measured in minutes of time westward from Greenwich), 
and a flag that ? if nonzero, indicates that Daylight Saving time applies locally during the 
appropriate part of the year. 

SEE ALSO 

date(l), gettimeofday(2), settimeofday(2), ctime(3) 



( 
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NAME 

time, ctime, Itime, gmtime - return system time 

SYNOPSIS 

integer function timeO 

character* (*) function ctime (stime) 
integer stime 

subroutine Itime (stime, tarray) 
integer stime, tarray(9) 

subroutine gmtime (stime, tarray) 
integer stime, tarray (9) 

DESCRIPTION 

Time returns the time since 00:00:00 GMT, Jan. 1, 1970, measured in seconds. This is the 
value of the UNIX system clock. 

Ctime converts a system time to a 24 character ASCII string. The format is described under 
ctime (3). No 'newline' or NULL will be included. 

Ltime and gmtime disect a UNIX time into month, day, etc., either for the local time zone or 
as GMT. The order and meaning of each element returned in tarray is described under 
ctime (3). 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

ctime(3), itime(3F), idate(3F), fdate(3F) 
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NAME 

times - get process times 

SYNOPSIS 

#include <sys/types»h> 
#include <sys/times.h> 

times (buffer) 
struct tms *buffer; 

DESCRIPTION 

This interface is obsolete*! by getrusage(2). 

times returns time-accounting information for the current process and for the terminated child 
processes of the current process. All times are in 1/HZ seconds, where HZ is 60. 

This is the structure returned by times: 

I* 

* Copyright (c) 1982, 1986 Regents of the University of California. 

* All rights reserved. The Berkeley software License Agreement 

* specifies the terms and conditions for redistribution. 

* @(#)times.h 7.1 (Berkeley) 6/4/86 
*/ 



( 



/* 



* Structure returned by times() 


*/ 






struct tms { 






time_J 


tms_ 


_utime; 


time„t 


tms„ 


_stime; 


time_t 


tms_ 


^cutime; 


time_t 


tms_ 


_cstime; 



/* user time */ 

/* system time */ 

/* user time, children */ 

/* system time, children */ 

}; 

The children times are the sum of the children's process times and their children's times. 

SEE ALSO 

time(l), getrusage(2), wait3(2), time(3) 



( 
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NAME 

timezone - supply timezone string 

SYNOPSIS 

char *timezone(zone, dst) 

DESCRIPTION 

NOTE: This routine is supplied for use with programs that need it. Recent changes in the 
Daylight Savings Time rules may make the value returned incorrect at times. Programs that 
need the current timezone should be changed to get it from the array tzname, as described in 
ctime(3). 

timezone returns the name of the time zone associated with its first argument, which is meas- 
ured in minutes westward from Greenwich. If the second argument is 0, the standard name is 
used, otherwise the Daylight Saving version. 

If the required name does not appear in a table built into the routine, the difference from 
GMT is produced; e.g., in Afghanistan timezone(-(60*4+30), 0) is appropriate because it is 4:30 
ahead of GMT and the string GMT+4:30 is produced. 

SEE ALSO 

gettimeofday(2), ctime(3) 
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NAME f 

ttyname, isatty, ttyslot - find name of a terminal 

SYNOPSIS 

char *ttyname (filedes) 

isatiy(filedes) 
ttyslotO 

DESCRIPTION 

ttyname returns a pointer to the null-terminated path name of the terminal device associated 
with file descriptor filedes (this is a system file descriptor and has nothing to do with the stan- 
dard I/O FILE typedef), 

isatty returns 1 if filedes is associated with a terminal device, otherwise. 

ttyslot returns the number of the entry in the ttys(5) file for the control terminal of the current 
process. 

FILES 

/dev/* 
/etc/ttys 

SEE ALSO 

ioctl(2), ttys(5) 

DIAGNOSTICS 

ttyname returns a null pointer (0) if filedes does not describe a terminal device in directory 
7dev ? . 

ttyslot returns if Vetc/ttys' is inaccessible or if it cannot determine the control terminal. 

ERRORS 

The return value points to static data whose content is overwritten by each call. 



( 



( 
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NAME 

ttynam, isatty - find name of a terminal port 

SYNOPSIS 

character* (*) function ttynam (limit) 

logical function isatty (lunit) 

DESCRIPTION 

Ttynam returns a blank padded path name of the terminal device associated with logical unit 

lunit. 

Isatty returns .true, if lunit is associated with a terminal device, .false, otherwise. 

FILES 

/dev/* 
Aisr/lib/libU77.a 

DIAGNOSTICS 

Ttynam returns an empty string (all blanks) if lunit is not associated with a terminal device in 
directory 7dev\ 
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NAME 

ualarm - schedule signal after specified time 

SYNOPSIS 

unsigned ualarm (value, interval) 
unsigned value; 
unsigned interval; 

DESCRIPTION 

This is a simplified interface to setitimer(2). 

ualarm causes signal SIGALRM, see signal (3C) 9 to be sent to the invoking process in a 
number of microseconds given by the value argument. Unless caught or ignored, the signal 
terminates the process. 

If the interval argument is nonzero, the SIGALRM signal will be sent to the process every 
interval microseconds after the timer expires (e.g. after value microseconds have passed). 

Because of scheduling delays, resumption of execution of when the signal is caught may be 
delayed an arbitrary amount. The longest specifiable delay time (on the vax) is 2147483647 
microseconds. 

The return value is the amount of time previously remaining in the alarm clock. 

SEE ALSO 

getitimer(2), setitimer(2), sigpause(2), sigvec(2), signal(3C), sleep(3), alarm(3), usleep(?* 



( 



( 



( 
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NAME 

handle_unaligned_traps, print_unaligned_summary - gather statistics on unaligned references 
SYNOPSIS 

void handle_unaligned_trapsO 

void print_unaligned_summaryO 

long unaligned_load_word(addr) 
char *addr; 

long unaligned_load_half(addr) 
char *addr; 

long unaligned_load_uhalf(addr) 
char *addr; 

float unaligned_load_float(addr) 
char *addr; 

double unaligned_load_double(addr) 
char *addr; 

void unaligned_store_word(addr, value) 
char *addr; 
long value; 

void unaligned_store_half(addr, value) 
char *addr; 
long value; 

void unaligned_store_float(addr, float value) 
char *addr; 
float value; 

void unaligned_store_double(addr, value) 
char *addr; 
double value; 

DESCRIPTION 

The first two routines implement a facility for finding unaligned references. The MIPS 
hardware traps load and store operations where the address is not a multiple of the number of 
bytes loaded or stored. Usually this trap indicates incorrect program operation and so by 
default the kernel converts this trap into a SIGBUS signal to the process, typically causing a 
core dump for debugging. 

Older programs developed on systems with lax alignment constraints sometimes make occa- 
sional misaligned references in course of correct operation. The best way to port such pro- 
grams to MIPS hardware is to correct the program by aligning the data. 
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A call to handlejunaligned_traps installs a SIGBUS handler that fixes unaligned memory refer- 
ences and keeps a record of the types, counts, and instruction addresses of these traps. A 
call to print _unaligned_summary prints the accumulated information. The following is an 
example of the output produced by printjunalignedjsummary : 

############################### 

# unaligned reference summary # 

# byte aligned lw 5000 33.3% # 

# byte aligned sw 10000 66.7% # 

# 0x0040024c/i 5000 33.3% 33.3% # 

# 0x004002a8/i 5000 33.3% 66.7% # 

# 0x004002b4/i 5000 33.3% 100.0% # 
############################### 

The listing is written to standard error and describes the type and number of unaligned refer- 
ences, followed by a list of every address that contains an unaligned reference. To convert 
the addresses into a dbx(l) script and run the script, pipe the output (both standard output 
and standard error) through the following command. The output from dbx will be the name 
of the function and line number of the misalignment. 

sed -n -e ? sf # [0-9a-f]*/i).*#$;l;p' | dbx prog 

This information can be used to decide the best way to correct the problem. If not all of the 
data can be aligned, or not all of the identified program locations that reference unaligned 
data can be changed, the sysmips{2) [MIPS_FIXADE] system call may be appropriate. 

The other routines load or store their indicated data type at the address specified. The 
address need not meet the normal alignment constraints. 

There exist fortran entry points for these routines so they may be called directly from fortran 
with the names documented here. 

DIAGNOSTICS 

If these routines try to load or store to an address that is outside the program's address space 
a SIGSEGV signal will be generated from inside these routines. If the program did not use 
these routines and the address was unaligned then the program would generate a SIGBUS sig- 
nal. This is because the check for alignment is done before the address is checked to be in 
the program's address space. 

SEE ALSO 

dbx(l), sysmips(2) [MIPSJFIXADE], signal(2), sigset(2). 



( 



( 
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NAME 

handle_unaligned_traps, print_unaligned_summary - gather statistics on unaligned references 

SYNOPSIS 

void handle_unaligned_traps 

void print_unaligned_summaryO 

long unaligned_load_word(addr) 
char *addr; 

long unaligned_load_half(addr) 
char *addr; 

long unaligned_load_uhalf(addr) 
char *addr; 

float unaligned_load_Jloat(addr) 
char *addr; 

double unaligned_load_double(addr) 
char *addr; 

void unaligned_store_word(addr, value) 
char *addr; 
long value; 

void unaligned_store_half(addr, value) 
char *addr; 
long value; 

void unaligned_store_float(addr, float value) 
char *addr; 
float value; 

void unaligned_store_double(addr, value) 
char *addr; 
double value; 

DESCRIPTION 

The first two routines implement a facility for finding unaligned references. The MIPS 
hardware traps load and store operations where the address is not a multiple of the number of 
bytes loaded or stored. Usually this trap indicates incorrect program operation and so by 
default the kernel converts this trap into a SIGBUS signal to the process, typically causing a 
core dump for debugging. 

Older programs developed on systems with lax alignment constraints sometimes make occa- 
sional misaligned references in course of correct operation. The best way to port such pro- 
grams to MIPS hardware is to correct the program by aligning the data. 

A call to handlejunalignedjtraps installs a SIGBUS handler that fixes unaligned memory refer- 
ences and keeps a record of the types, counts, and instruction addresses of these traps. A 
call to print junalignedjsummary prints the accumulated information. The following is an 
example of the output produced by print junalignedjsummary : 
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############################### 

# unaligned reference summary # 

# byte aligned Iw 5000 333% # 

# byte aligned sw 10000 66.7% # 

# 0x0040024c/i 5000 333% 333% # 

# 0x004002a8/i 5000 333% 66.7% # 

# Qx004002b4/i 5000 333% 100.0% # 
############################### 

The listing is written to standard error and describes the type and number of unaligned refer- 
ences, followed by a list of every address that contains an unaligned reference. To convert 
the addresses into a dbx(l) script and run the script, pipe the output (both standard output 
and standard error) through the following command. The output from dbx will be the name 
of the function and line number of the misalignment. 

sed -n -e 9 s{ # [0-9a-f]*/i).*#$;l;p' | dbx prog 

This information can be used to decide the best way to correct the problem. If not all of the 
data can be aligned, or not all of the identified program locations that reference unaligned 
data can be changed, the fixade (2) $y$mip$(2) [MPS_FIXADE] system call may be appropriate. 

The other routines load or store their indicated data type at the address specified. The 
address need not meet the normal alignment constraints. 

There exist fortran entry points for these routines so they may be called directly from fortran 
with the names documented here. 

DIAGNOSTICS 

If these routines try to load or store to an address that is outside the program's address space ^ 

a SIGSEGV signal will be generated from inside these routines. If the program did not use I 

these routines and the address was unaligned then the program would generate a SIGBUS sig- ^ 

nal. This is because the check for alignment is done before the address is checked to be in 
the program's address space. 

SEE ALSO 

dbx(l), fixade(2), sigvec(2). sysmips(2) [MIPS_FIXADE] ? signal(2), sigset(2). 



( 
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NAME 

ungetc - push character back into input stream 

SYNOPSIS 

#include <stdio,h> 

ungetc (c, stream) 
FILE *stream; 

DESCRIPTION 

ungetc pushes the character c back on an input stream. That character will be returned by the 
next getc call on that stream, ungetc returns c. 

One character of pushback is guaranteed provided something has been read from the stream 
and the stream is actually buffered. Attempts to push EOF are rejected. 

f seek (3S) erases all memory of pushed back characters. 

SEE ALSO 

getc(3S), setbuf(3S), fseek(3S) 

DIAGNOSTICS 

ungetc returns EOF if it can't push a character back. 
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NAME 

unlink - remove a directory entry 

SYNOPSIS 

integer function unlink (name) 
character* (*) name 

DESCRIPTION 

Unlink causes the directory entry specified by pathname name to be removed. If this was the 
last link to the file, the contents of the file are lost, The returned value will be zero if success- 
ful; a system error code otherwise. 

FILES 

/usr/lib/libU77.a 

SEE ALSO 

unlink(2), link(3F), filsys(5), perror(3F) 

BUGS 

Pathnames can be no longer than MAXPATHLEN as defined in <sys/param.h>. 



( 



( 
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NAME 

usleep - suspend execution for interval 

SYNOPSIS 

usleep (u seconds) 
unsigned useconds; 

DESCRIPTION 

The current process is suspended from execution for the number of microseconds specified by 
the argument. The actual suspension time may be an arbitrary amount longer because of other 
activity in the system or because of the time spent in processing the call. 

The routine is implemented by setting an interval timer and pausing until it occurs. The previ- 
ous state of this timer is saved and restored. If the sleep time exceeds the time to the expira- 
tion of the previous timer, the process sleeps only until the signal would have occurred, and 
the signal is sent a short time later. 

This routine is implemented using setitimer(2); it requires eight system calls each time it is 
invoked. A similar but less compatible function can be obtained with a single select(2); it 
would not restart after signals, but would not interfere with other uses of setitimer. 

SEE ALSO 

setitimer(2), getitimer(2), sigpause(2), ualarm(3), sleep(3) ? alarm (3) 
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NAME I 

utinie - set file times 

SYNOPSIS 

#include <sys/types.h> 

utime(file, timep) 
char *file; 
time__t timep [2]; 

DESCRIPTION 

This interface is obsolete*! by utimes(2). 

The utime call uses the 'accessed' and 'updated' times in that order from the timep vector to 
set the corresponding recorded times for file . 

The caller must be the owner of the file or the super-user. The 'mode-changed' time of the 
file is set to the current time. 

SEE ALSO 

utimes(2) ? stat(2) 



( 



( 
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NAME 

valloc - aligned memory allocator 

SYNOPSIS 

char *valloc(size) 
unsigned size; 

DESCRIPTION 

Valloc is obsoleted by the current version of malloc, which aligns page-sized and larger allo- 
cations. 

valloc allocates size bytes aligned on a page boundary. It is implemented by calling malloc{3) 
with a slightly larger request, saving the true beginning of the block allocated, and returning a 
properly aligned pointer. 

DIAGNOSTICS 

valloc returns a null pointer (0) if there is no available memory or if the arena has been detect- 
ably corrupted by storing outside the bounds of a block. 

ERRORS 

vfree isn't implemented. 
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NAME I 

varargs - variable argument list 

SYNOPSIS 

#inc!ude <varargs.h> 

function(Y&__&list) 

va_dcl 

va _Jist pvar ; 

va_start(pvar); 

f = va__arg(/?var, type); 

va_end(pvar); 

DESCRIPTION 

This set of macros provides a means of writing portable procedures that accept variable argu- 
ment lists. Routines having variable argument lists (such as print j '(3)) that do not use varargs 
are inherently nonportable, since different machines use different argument passing conven- 
tions. 

vajxlist is used in a function header to declare a variable argument list. 

va_dcl is a declaration for va_ali$t. Note that there is no semicolon after vajdcl. 

vajist is a type which can be used for the variable pvar, which is used to traverse the list. 
One such variable must always be declared. 

va^start(pvar) is called to initialize pvar to the beginning of the list. 

va_arg(pvar , type) will return the next argument in the list pointed to by pvar. type is the type 

to which the expected argument will be converted when passed as an argument. In standard 

C, arguments that are char or short should be accessed as int, unsigned char or unsigned f 

short are converted to unsigned int, and float arguments are converted to double. Different V 

types can be mixed, but it is up to the routine to know what type of argument is expected, 

since it cannot be determined at runtime. 

va_end(pvar) is used to finish up. 

Multiple traversals, each bracketed by vajstart ,,. vajend, are possible. 

EXAMPLE 

#include <varargs.h> 
execl(va_alist) 

va__dci 

{ 

vajist ap; 
char *file; 
char *args[100]; 
int argno *= 0; 

ya_start(ap); 

file = va_arg(ap, char *); 

while (args[argno4-+] = va_arg(ap, char *)) 

9 

va_end(ap); 

return execv(file, args); 



( 
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ERRORS 

It is up to the calling routine to determine how many arguments there are, since it is not possi- 
ble to determine this from the stack frame. For example, execl passes a to signal the end of 
the list, printf can tell how many arguments are supposed to be there by the format. 

The macros vajstart and vajend may be arbitrarily complex; for example, va_start might con- 
tain an opening brace, which is closed by a matching brace in va_end. Thus, they should only 
be used where they could be placed within a single complex statement. 
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NAME 

verdixlib - MlPS-supported Ada library packages 

SYNOPSIS 

verdixlib 

DESCRIPTION 

verdixlib contains the packages MATH, COMPLEX^ ARITH, ORDERING, 
COMMAND JUNE, and UNDCCALLS, MATH uses the UNIX C mathematics llibrary to 
provide most standard mathematical functions and many constants, COMPLEX. ARITH 
defines the private type type COMPLEX and provides arithmetic functions for complex 
numbers. ORDERING includes sorting packages (QUICKSORT, HEAPSORT, and 
INSERTIONSORT) and a permuting package (PERMUTE). 

COMMAND JLINE lets the user access the command line arguments and environments 
variables of an Ada program. UNIXXALLS provides an interface to commonly used UNIX 
system calls. 

TYPES AND FUNCTIONS 

private type COMPLEX in COMPLEX-ARITH 

FILES 

/usr/vads5/verdislib/* 

SEE ALSO 

MATH fully describes the MATH and COMPLEX^ARITH packages. Otner libraries of Ada 
programs are standard, publiclib, and examples. 
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NAME 

vlimit - control maximum system resource consumption 

SYNOPSIS 

#include <sys/vlimit.h> 

vlimit(resource, value) 

DESCRIPTION 

This facility is superseded by getrlimit(2). 

Limits the consumption by the current process and each process it creates to not individually 
exceed value on the specified resource. If value is specified as -1, then the current limit is 
returned and the limit is unchanged. The resources which are currently controllable are: 

LIM_NORAISE A pseudo-limit; if set non-zero then the limits may not be raised. 

Only the super-user may remove the noraise restriction. 

LIM_CPU the maximum number of cpu-seconds to be used by each process 

LIM_FSIZE the largest single file which can be created 

LINLDATA the maximum growth of the data+stack region via sbrk(2) beyond 

the end of the program text 

LIM_STACK the maximum size of the automatically-extended stack region 

LIM_CORE the size of the largest core dump that will be created. 

LIM_MAXRSS a soft limit for the amount of physical memory (in bytes) to be 

given to the program. If memory is tight, the system will prefer to 
take memory from processes which are exceeding their declared 
LIM_MAXRSS. 

Because this information is stored in the per-process information this system call must be exe- 
cuted directly by the shell if it is to affect all future processes created by the shell; limit is thus 
a built-in command to c$h{l). 

The system refuses to extend the data or stack space when the limits would be exceeded in the 
normal way; a break call fails if the data space limit is reached, or the process is killed when 
the stack limit is reached (since the stack cannot be extended, there is no way to send a sig- 
nal!). 

A file i/o operation which would create a file which is too large will cause a signal SIGXFSZ to 
be generated, this normally terminates the process, but may be caught. When the cpu time 
limit is exceeded, a signal SIGXCPU is sent to the offending process; to allow it time to pro- 
cess the signal it is given 5 seconds grace by raising the cpu time limit. 

SEE ALSO 

csh(l) 

ERRORS 

LIM_NORAISE no longer exists. 
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NAME 

vtimes - get information about resource utilization 

SYNOPSIS 

#include <sys/vtimeSoh> 

vtimes (par_vm, chuvm) 

struct vtimes *par_vm, *ch__vm; 

DESCRIPTION 

This facility is superseded by getrusage(2). 

vtimes returns accounting information for the current process and for the terminated child 
processes of the current process. Either par_ym or chj>m or both may be 0, in which case 
only the information for the pointers which are non-zero is returned. 

After the call, each buffer contains information as defined by the contents of the include file 

lusrlinclude/sys/vtimesM: 

struct vtimes { 

int vm_utime; /* user time (*HZ) */ 

int vm_stime; /* system time (*HZ) */ 

/* divide next two by utime+stime to get averages */ 
unsigned vmjdsrss; /* integral of d+s rss */ 

unsigned vmjxrss; /* integral of text rss */ 

/* maximum rss */ 

/* major page faults */ 

/* minor page faults */ 

/* number of swaps */ 

/* block reads */ 

/* block writes */ 

}; 

The vmjutime and vmjstime fields give the user and system time respectively in 60ths of a 
second (or 50ths if that is the frequency of wall current in your locality.) The vmjdrss and 
vmjxrss measure memory usage. They are computed by integrating the number of memory 
pages in use each over cpu time. They are reported as though computed discretely, adding the 
current memory usage (in 512 byte pages) each time the clock ticks. If a process used 5 core 
pages over 1 cpu-second for its data and stack, then vmjdsrss would have the value 5*60, 
where vmjutime +vm_stime would be the 60. vmjdsrss integrates data and stack segment usage, 
while vmjxrss integrates text segment usage, vmjnaxrss reports the maximum instantaneous 
sum of the text-i-data-f- stack core-resident page count, 

The vm_jnajflt field gives the number of page faults which resulted in disk activity; the 
vm_minflt field gives the number of page faults incurred in simulation of reference bits; 
vmjiswap is the number of swaps which occurred. The number of file system input/output 
events are reported in vmjnblk im&'vm_oublk These numbers account only for real i/o; data 
supplied by the caching mechanism is charged only to the first process to read or write the 
data. 

SEE ALSO 

time(2), wait3(2), getrusage(2) 



int 


vm__maxrss 


int 


vm_jnajflt; 


int 


vmjmrinflt; 


int 


vm_nswap; 


int 


vmjnblk; 


int 


vm__oublk; 



( 



c 



( 
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NAME 

wait - wait for a process to terminate 

SYNOPSIS 

integer function wait (status) 
integer status 

DESCRIPTION 

Wait causes its caller to be suspended until a signal is received or one of its child processes 
terminates. If any child has terminated since the last wait, return is immediate; if there are no 
children, return is immediate with an error code. 

If the returned value is positive, it is the process ID of the child and status is its termination 
status (see wait(2)). If the returned value is negative, it is the negation of a system error code. 



FILES 



/usr/lib/libU77.a 



SEE ALSO 

wait (2), signal(3F), kill(3F), perror(3F) 
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NAME 



xdr - library routines for external data representation 



DESCRIPTION 

These routines allow C programmers to describe arbitrary data structures in a machine- 
independent fashion. Data for remote procedure calls are transmitted using these routines. 

FUNCTIONS 

xdr_array() 

xdrJ>ool() 

xdr_bytes() 

xdr_destroy() 

xdr„double() 

xdr_enum() 

xdrJioatQ 

xdr_getpos() 

xdrJnlineQ 

xdrJntQ 

xdrJong() 

xdr_opaque() 

xdr_jeference() 

xdrjsetposQ 

xdrjshortQ 

xdr_string() 

xdr T _u_int() 

xdr_uJong() 

xdr„u_short() 

xdr_union() 

xdr_void() 

xdr_wrapstring() 

xdrmem^createQ 

xdrrec_create() 

xdrrec_endofrecQrd() 

xdrrec_eof() 

xdrrea_skiprecord() 

xdrstdio_create() 



translate arrays to/from external representation 

translate Booleans to/from external representation 

translate counted byte string? to/from external representation 

destroy XDR stream and free associated memory 

translate double precision to/from external representation 

translate enumerations to/from external representation 

translate floating point to/from external representation 

return current position in XDR stream 

invoke the in-line routines associated with XDR stream 

translate integers to/from external representation 

translate long integers to/from external representation 

translate fixed-size opaque data to/from external representation 

chase pointers within structures 

change current position in XDR stream 

translate short integers to/from external representation 

translate null-terminated strings to/from external representation 

translate unsigned integers to/from external representation 

translate unsigned long integers to/from external representation 

translate unsigned short integers to/from external representation 

translate discriminated unions to/from external representation 

always return one (1) 

package RPC routine for XDR routine, or vice-versa 

initialize an XDR stream 

initialize an XDR stream with record boundaries 

mark XDR record stream with an end-of-record 

mark XDR record stream with an end-of-file 

skip remaining record in XDR record stream 

initialize an XDR stream as standard I/O FILE stream 



c 



SEE ALSO 

External Data Representation Protocol Specification , in Networking on the Sun Workstation . 



( 
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NAME 

ypclnt, yp_get_default_domain, yp^bind, yp^unbind, yp^match, yp_first, yp_next, yp_all, 
yp_order, yp_master, yperr_string, ypprot_err - yellow pages client interface 

SYNOPSIS 

#include <rpcsvc/ypclnt.h> 

yp_bind (in domain) ; 
char *indomain; 

void yp_unbind(indomain) 
char *indomain; 

yp_get__default_domain (outdomain) ; 
char **outdomain; 

yp_match(indomain, inmap, inkey, inkeylen, outval, outvallen) 

char *indomain; 

char *inmap; 

char *inkey; 

int inkeylen; 

char **outval; 

int *outvallen; 

yp_first(indomain, inmap, outkey, outkeylen, outval, outvallen) ! 

char *indomain; 

char *inmap; 

char **outkey; 

int *outkeylen; 

char **outval; 

int *outvallen; 

yp_next(indomain, inmap, inkey, inkeylen, outkey, outkeylen, outval, outvallen); 

char *indomain; 

char *inmap; 

char *inkey; 

int inkeylen; 

char **outkey; 

int *outkeylen; 

char **outval; 

int *outvallen; 

yp_all(indomain, inmap, in callback); 

char *indomain; 

char *inmap; 

struct ypalLcallback incallback; 

yp_order(indomain, inmap, outorder); 
char *indomain; 
char *inmap; 
int *outorder; 

yp_master(indomain, inmap, outname); 
char *indomain; 
char *inmap; 
char **outname; 

char *yperr_string(incode) 
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int incode; 

ypprot_err (incode) 
unsigned Int incode; 

DESCRIPTION 

This package of functions provides an interface to the yellow pages (YP) network lookup ser- 
vice. The package can be loaded from the standard library, /lib/libc.a. Refer to ypfiles(5) 
and ypserv(8) for an overview of the yellow pages, including the definitions of map and 
domain , and a description of the various servers, databases, and commands that comprise the 
YP. 

All input parameters names begin with in. Output parameters begin with out. Output param- 
eters of type char ** should be addresses of uninitialized character pointers. Memory is allo- 
cated by the YP client package using malloc(3), and may be freed if the user code has no con- 
tinuing need for it. For each outkey and outval, two extra bytes of memory are allocated at the 
end that contain NEWLINE and NULL, respectively, but these two bytes are not reflected in 
outkeylen or outvallen . indomain and inmap strings must be non-null and null-terminated. 
String parameters which are accompanied by a count parameter may not be null, but may 
point to null strings, with the count parameter indicating this. Counted strings need not be 
null-terminated. 

All functions in this package of type int return if they succeed, and a failure code 
(YPERRjur**) otherwise. Failure codes are described under DIAGNOSTICS below. 

The YP lookup calls require a map name and a domain name, at minimum. It is assumed that 
the client process knows the name of the map of interest. Client processes should fetch the 
node's default domain by calling yp__get„default_domainO » and use the returned outdomain 
as the indomain parameter to successive YP calls. 

To use the YP services, the client process must be "bound" to a YP server that serves the 
appropriate domain using ypjbind. Binding need not be done explicitly by user code; this is 
done automatically whenever a YP lookup function is called, ypjbind can be called directly 
for processes that make use of a backup strategy (e.g., a local file) in cases when YP services 
are not available. 

Each binding allocates (uses up) one client process socket descriptor; each bound domain 
costs one socket descriptor. However, multiple requests to the same domain use that same 
descriptor. yp_unbind() is available at the client interface for processes that explicitly manage 
their socket descriptors while accessing multiple domains. The call to yp__unbind() make the 
domain unbound, and free all per-process and per-node resources used to bind it. 

If an RPC failure results upon use of a binding, that domain will be unbound automatically. 
At that point, the ypclnt layer will retry forever or until the operation succeeds, provided that 
ypbind is running, and either 

a) the client process can't bind a server for the proper domain, or 

b) RPC requests to the server fail. 

If an error is not RPC-related, or if ypbind is not running, or if a bound ypserv process returns 
any answer (success or failure), the ypclnt layer will return control to the user code, either 
with an error code, or a success code and any results. 

ypjnatch returns the value associated with a passed key. This key must be exact; no pattern 
matching is available. 

yp-flrst returns the first key-value pair from the named map in the named domain. 



c 



c 



( 
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yp_next() returns the next key-value pair in a named map. The inkey parameter should be the 
outkey returned from an initial call to ypJirstQ (to get the second key-value pair) or the one 
returned from the nth call to yp_next() (to get the nth + second key-value pair). 

The concept of first (and, for that matter, of next) is particular to the structure of the YP map 
being processing; there is no relation in retrieval order to either the lexical order within any 
original (non-YP) data base, or to any obvious numerical sorting order on the keys, values, or 
key-value pairs. The only ordering guarantee made is that if the yp-first() function is called on 
a particular map, and then the yp_next() function is repeatedly called on the same map at the 
same server until the call fails with a reason of YPERR_NOMORE, every entry in the data 
base will be seen exactly once. Further, if the same sequence of operations is performed on 
the same map at the same server, the entries will be seen in the same order. 

Under conditions of heavy server load or server failure, it is possible for the domain to 
become unbound, then bound once again (perhaps to a different server) while a client is run- 
ning. This can cause a break in one of the enumeration rules; specific entries may be seen 
twice by the client, or not at all. This approach protects the client from error messages that 
would otherwise be returned in the midst of the enumeration. The next paragraph describes a 
better solution to enumerating all entries in a map. 

yp-jall provides a way to transfer an entire map from server to client in a single request using 
TCP (rather than UDP as with other functions in this package). The entire transaction take 
place as a single RFC request and response. You can use ypjodl just like any other YP pro- 
cedure, identify the map in the normal manner, and supply the name of a function which will 
be called to process each key-value pair within the map. You return from the call to yp_all 
only when the transaction is completed (successfully or unsuccessfully), or your "foreach" 
function decides that it doesn't want to see any more key-value pairs. 

The third parameter to yp_all is 

struct ypalLcallback *incallback { 
int (*foreach)(); 
char *data; 

}; 

The function foreach is called 

foreaeh(in$tatus, inkey, inkeyien, inval 9 invallen, in data); 

int instatus; 

char *inkey; 

int inkeyien; 

char *invai; 

int invailien; 

char *indata; 

The instatus parameter will hold one of the return status values defined in 
<rpcsvc/yp_prot.h> - either YP_TRUE or an error code. (See ypprot_err , below, for a func- 
tion which converts a YP protocol error code to a ypclnt layer error code.) 

The key and value parameters are somewhat different than defined in the synopsis section 
above. First, the memory pointed to by the inkey and inval parameters is private to the yp_all 
function, and is overwritten with the arrival of each new key-value pair. It is the responsibility 
of the foreach function to do something useful with the contents of that memory, but it does 
not own the memory itself. Key and value objects presented to the foreach function look 
exactly as they do in the server's map - if they were not newline-terminated or null-terminated 
in the map, they won't be here either. 
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The indata parameter is the contents of the incallhack->data element passed to ypjall . The 
data element of the callback structure may be used to share state information between the 
foreach function and the mainline code. Its use is optional, and no part of the YP client 
package inspects its contents - cast it to something useful, or ignore it as you see fit. 

The foreach function is a Boolean. It should return zero to indicate that it wants to be called 
again for further received key-value pairs, or non-zero to stop the flow of key-value pairs. If 
foreach returns a non-zero value, it is not called again; the functional value of ypjall is then 0. 

yp_order returns the order number for a map. 

ypjfnaster returns the machine name of the master YP server for a map. 

yperrjstring returns a pointer to an error message string that is null-terminated but contains no 
period or newline. 

ypprot_err takes a YP protocol error code as input, and returns a ypclnt layer error code, 
which may be used in turn as an input to yperrjstring . 

/usr/include/rpcsvc/ypclnt.h 
/usr/include/rpcsvc/yp„prot .h 

SEE ALSO 

ypfiles(5), ypserv(8), 

DIAGNOSTICS 

All integer functions return if the requested operation is successful, or one of the following 
errors if the operation fails. 



( 



FILES 



#define YPERR_BADARGS 
#define YPERR_RPC 
#define YPERR_DOMAIN 
#define YPERR_MAP 
#define YPERR_KEY 
#define YPERR_YPERR 
#define YPERRJRESRC 
#define YPERR_NOMORE 
#define YPERR_PMAP 
#define YPERR_YPBIND 
#define YPERR_YPSERV 
#define YPERR.NODOM 



1 


/* 


2 


/* 


3 


/* 


4 


/* 


5 


/* 


6 


/* 


7 


/* 


8 


/* 


9 


/* 


10 /* 


11 /* 


12 /* 



args to function are bad */ 

RPC failure - domain has been unbound */ 

can't bind to server on this domain */ 

no such map in server's domain */ 

no such key in map */ 

internal yp server or client error */ 

resource allocation failure */ 

no more records in map database */ 

can't communicate with portmapper */ 

can't communicate with ypbind */ 

can't communicate with ypserv */ 

local domain name not set */ 



c 
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NAME 

yppasswd - update user password in yellow pages 

SYNPOSIS 

#include <rpcsvc/yppasswd.h> 

yppasswd (oldpass, newpw) 
char *oldpass 
struct passwd *newpw; 

DESCRIPTION 

If oldpass is indeed the old user password, this routine replaces the password entry with 
newpw. It returns if successful. 

RPC INFO 

program number: 

YPPASSWDPROG 

xdr routines: 

xdr_jppasswd(xdrs, yp) 
XDR*xdrs; 
struct yppasswd *yp; 
xdr_yppasswd(xdrs, pw) 
XDR*xdrs; 
struct passwd *pw; 
procs: 

YPPASSWDPROCJJPDATE 

Takes struct yppasswd as argument, returns integer. 
Same behavior as yppasswd() wrapper. 
Uses UNIX authentication, 
versions: 

YPPASSWD VERSJ3RIG 

structures: 

struct yppasswd { 

char *oldpass; /* old (unencrypted) password */ 
struct passwd newpw; /* new pw structure */ 

}; 

SEE ALSO 

yppasswd(l), yppasswdd(8C) 
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NAME 



acct - execution accounting file 



SYNOPSIS 

#include <sys/acct.h> 

DESCRIPTION 

The acct (2) system call arranges for entries to be made in an accounting file for each process 
that terminates. The accounting file is a sequence of entries whose layout, as defined by -the 
include file is: 

/* 

* Copyright (c) 1982, 1986 Regents of the University of California. 

* All rights reserved. The Berkeley software License Agreement 

* specifies the terms and conditions for redistribution. 



*/ 



@(#)acct.h 7.1 (Berkeley) 6/4/86 



/* 

* Accounting structures; 

* these use a compj: type which is a 3 bits base 8 

* exponent, 13 bit fraction "floating point" number. 

* Units are 1/AHZ seconds. 
*/ 

typedef u_short comp_t; 



struct 


acct 




{ 








char 


ac_comm[10]; 




comp_t 


ac_utime; 




comp_t 


ac„stime; 




comp_t 


ac_etime; 




time__t 


ac_btime; 




uid_t 


ac_uid; 




gid_t 


ac_gid; 




short 


ac_mem; 




comp_t 


ac_io; 




dev_t 


ac_tty; 




char 


acjflag; 



}; 

#defineAFORK 0001 
#defineASU 0002 

#defineACOMPAT 0004 
#defiheACORE 0010 
#defineAXSIG 0020 



/* Accounting command name */ 
/* Accounting user time */ 
/* Accounting system time */ 
/* Accounting elapsed time */ 
/* Beginning time */ 
/* Accounting user ID */ 
/* Accounting group ID */ 
/* average memory usage */ 
/* number of disk IO blocks */ 
/* control typewriter */ 
/* Accounting flag */ 



/* has executed fork, but no exec */ 
/* used super-user privileges */ 
/* used compatibility mode */ 
/* dumped core */ 
/* killed by a signal */ 



/* 

* 1/AHZ is the granularity of the data encoded in the various 

* comp_t fields. This is not necessarily equal to hz. 
*/ 

#define AHZ 64 
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#ifdef KERNEL 

struct acct acctbuf; 

struct vnode *acctp; 

#endif 

If the process was created by an ewcve(2), the first 10 characters of the filename appear in 
acjcomrn. The accounting flag contains bits indicating whether execve(2) was ever accom- 
plished, and whether the process ever had super-user privileges. 

SEE ALSO 

acct(2) ? execve(2) ? sa(8) 



( 



( 
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NAME 

cshrc - startup file for csh command 

SYNOPSIS 

$HOME/.cshrc 

DESCRIPTION 

When csh(l) is executed without the option *-f, it reads commands from the file 
$HOME/. cshrc. If the shell is a login shell (this can be done by logging in, executing the 
login(l) command, or executing su(l) with the — option), the file $HOME/.login is executed 
after the .cshrc file. 

This file should do the following: 

Set the path variable (this must be here if rsh(lc) or rcp(lc) is to work properly. If 
these are not required, the path may be set in the file $HOMEA login). 

Set up aliases (interactive shells only). 

Set up internal csh variables for things like line editing, filename completion, history, 
etc (interactive shells only). 

Set the prompt to be used when the shell is invoked as a non-login shell (interactive 
shells only). 

In general, the format of the file is as follows (items in {} should be replaced by appropriate 
commands and/or pathnames): 

set path=( . \ 

{personal bins} \ 
{local/project bins} \ 
$path \ 
/usr/new \ 
/usr/new/mh \ 

) 

set cdpath=( {path for use with cd command ) 
if ($?prompt) then 

{set prompt} 

{set variables and aliases for interactive shells} 
else 

{set variables and aliases for non-interactive shells} 
endif 
{set variables and aliases for all shells} 

There is almost never a reason to execute any commands in this file other than those for set- 
ting up variables and aliases. Special care should be taken to avoid executing commands like 
biff(l), sysline(l), or tset(l), especially in non-interactive shells. 

Environment variables can be set in $HOME/. login at login time, since they are passed to all 
subshells. In fact, setting environment variables in .cshrc can cause unexpected results. 

An example of a useful .cshrc file is: 

#!/bin/csh -f 
# .cshrc for root 

set path = (/usr/ucb /bin /usr/bin /etc .) 
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# Things for interactive shells 
if ($?prompt) then 

alias j jobs 4 
alias h history 
alias z suspend 
set history=^100 
else 

# nothing for non-interactive shells 
enclif 

SEE ALSO 

csh(l), su(l), login(5), proflle(5) 



( 



( 
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NAME 



printcap - printer capability database 



SYNOPSIS 

/etc/printcap 

DESCRIPTION 

printcap is a simplified version of the termcap{5) database used to describe line printers. The 
spooling system accesses the printcap file every time it is used, allowing dynamic addition and 
deletion of printers. Each entry in the database is used to describe one printer. This database 
can not be substituted for, as is possible for termcap, because it can allow accounting to be 
bypassed. 

The default printer is normally Ip , though the environment variable PRINTER can be used to 
override this. Each spooling utility supports an option, —Fprinter, to allow explicit naming of 
a destination printer. 

Refer to the 4.2BSD Line Printer Spooler Manual for a complete discussion on how setup the 
database for a given printer. 

CAPABILITIES 

Refer to termcap for a description of the file layout. 

Description 

name of accounting file 

if Ip is a tty, set the baud rate (ioctl call) 

cifplot data filter 

tex data filter (DVI format) 

if Ip is a tty, clear flag bits (sgtty.h) 

string to send for a form feed 

print a form feed when device is opened 

like 4 fc ? but set bits 

graph data filter (plot (3X) format) 

driver supports (non standard) ioctl to indent printout 

name of text filter which does accounting 

error logging file name 

name of lock file 

device name to open for output 

maximum file size (in BUFSIZ blocks), zero = unlimited 

next directory for list of queues (unimplemented) 

ditroff data filter (device independent troff) 

name of output filtering program 

page length (in lines) 

page width (in characters) 

page width in pixels (horizontal) 

page length in pixels (vertical) 

filter for printing FORTRAN style text files 

machine name for remote printer 

remote printer name argument 

restrict remote users to those with local accounts 

open the printer device for reading and writing 

short banner (one line only) 

suppress multiple copies 

spool directory 

suppress form feeds 

suppress printing of burst page header 



Name 


Type 


Default 


af 


str 


NULL 


br 


num 


none 


cf 


str 


NULL 


df 


str 


NULL 


fc 


num 





ff 


str 


"\f" 


fo 


bool 


false 


fs 


num 





gf 


str 


NULL 


ic 


bool 


false 


if 


str 


NULL 


If 


str 


"/dev/console" 


lo 


str 


"lock" 


IP 


str 


"/dev/lp" 


mx 


num 


1000 


nd 


str 


NULL 


nf 


str 


NULL 


of 


str 


NULL 


Pi 


num 


66 


pw 


num 


132 


px 


num 





py 


num 





rf 


str 


NULL 


rm 


str 


NULL 


rp 


str 


"Ip" 


rs 


bool 


false 


rw 


bool 


false 


sb 


bool 


false 


sc 


bool 


false 


sd 


str 


"/usr/spool/lpd' ? 


sf 


bool 


false 


sh 


bool 


false 
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tf 


str 


NULL 


tr 


str 


NULL 


vf 


str 


NULL 


xc 


num 





xs 


num 






status file name 

troff data filter (cat phototypesetter) 

trailer string to print when queue empties 

raster image filter 

if Ip is a tty, clear local mode bits (tty (4)) 

like 'xc' but set bits 

Error messages sent to the console have a carriage return and a line feed appended to them, 
rather than just a line feed. 

If the local line printer driver supports indentation, the daemon must understand how to 
invoke it. 

EXAMPLE 
# 

# This is a sample of printcap entries used by various printers/plotters 
# 

# Dec Writer over a tty line. 

Ip |ap |arpa |ucbarpa|LA-180 Dec Writer HI: 

:br#1200:fs#06320:tr=of=/usr/lib/lpf:lf=/usr/adm/lpd-errs: 

# typical remote printer entry 
ucbvax|vax|vx|ucbvax line printer: 

:lp= :rm=ucbvax:sd=/usr/spool/vaxlpd :lf ==/usr/adm/lpd-errs: 
varian|va [Benson Varian: 

:lp=/dev/va0:sd=/usr/spool/vad:mx#2000:pl#58:px#2112:py#1700:tr= 

:of=/usr/lib/vpf:if=^/usr/lib/vpf:tf-/usr/lib/rvcat:cf=/usr/lib/vdmp: 

:gf=/usr/lib/vplotf:df=/usr/local/dvif: 

: vf =/usr/lib/vpltdmp :lf =/usr/adm/lpd-errs : 
versatec |vp [Versatec plotter: 

:lp=/dev/vp0:sd=/usr/spool/vpd:sb:sf:mx#0:pw#106:pl#86:px#7040:py#2400: 

:of=/usr/lib/vpfW:if-/usr/lib/vpsf:tf=/usr/lib/vc^t:cf=/usr/lib/vdmp: 

:gf =/usr/lib/vplotf : vf =/usr/lib/vpltdmp :lf =/usr/adm/lpd-errs : 

:tr- 



( 



SEE ALSO 

termcap(5), Ipc(8), lpd(8), pac(8), lpr(l), lpq(l) ? lprm(l) 
4.2BSD Line Printer Spooler Manual 



( 
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NAME 

termcap - terminal capability data base 

SYNOPSIS 

/etc/termcap 

DESCRIPTION 

termcap is a data base describing terminals, used, e.g., by vz(l) and curses (3X). Terminals 
are described in termcap by giving a set of capabilities that they have and by describing how 
operations are performed. Padding requirements and initialization sequences are included in 
termcap . 

Entries in termcap consist of a number of ': '-separated fields. The first entry for each terminal 
gives the names that are known for the terminal, separated by 'f characters. The first name is 
always two characters long and is used by older systems which store the terminal type in a 16- 
bit word in a system-wide data base. The second name given is the most common abbrevia- 
tion for the terminal, the last name given should be a long name fully identifying the terminal, 
and all others are understood as synonyms for the terminal name. All names but the first and 
last should be in lower case and contain no blanks; the last name may well contain upper case 
and blanks for readability. 

Terminal names (except for the last, verbose entry) should be chosen using the following con- 
ventions. The particular piece of hardware making up the terminal should have a root name 
chosen, thus "hp2621". This name should not contain hyphens. Modes that the hardware 
can be in or user preferences should be indicated by appending a hyphen and an indicator of 
the mode. Therefore, a "vtlQO" in 132-column mode would be "vtlOO-w". The following 
suffixes should be used where possible: 

Suffix Meaning Example 

-w Wide mode (more than 80 columns) vtlOO-w 

-am With automatic margins (usually default) vtlOO-am 

-nam Without automatic margins vtlOO-nam 

-n Number of lines on the screen aaa-60 

-na No arrow keys (leave them in local) conceptlOO-na 

-np Number of pages of memory conceptlOCMp 

-rv Reverse video conceptlOO-rv 

CAPABILITIES 

The characters in the Notes field in the table have the following meanings (more than one may 
apply to a capability): 

N indicates numeric parameter(s) 

P indicates that padding may be specified 

* indicates that padding may be based on the number of lines affected 

o indicates capability is obsolete 

"Obsolete" capabilities have no terminfo equivalents, since they were considered useless, or 
are subsumed by other capabilities. New software should not rely on them at all. 

Name Type Notes Description 

Sent by shifted save key 
Sent by shifted suspend key 
Sent by shifted undo key 
Sent by shifted help key 
Sent by shifted home key 
Sent by shifted input key 
Sent by shifted left-arrow key 
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!1 


str 


!2 


str 


!3 


str 


#1 


str 


#2 


str 


#3 


str 


#4 


str 
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Sent by redo key I 

Sent by help key ^ 

Sent by mark key 

Sent by message key 

Sent by move key 

Sent by next-object key 

Sent by open key 

Sent by options key 

Sent by previous-object key 

Sent by print or copy key 

Sent by shifted message key 

Sent by shifted move key 

Sent by shifted next-object key 

Sent by shifted options key 

Sent by shifted previous-object key 

Sent by shifted print or copy key 

Sent by shifted redo key 

Sent by shifted replace key 

Sent by shifted right-arrow key 

Sent by shifted resume key 

Sent by shifted cancel key 

Sent by ref (erence) key 

Sent by refresh key 

Sent by replace key 

Sent by restart key 

Sent by resume key f 

Sent by save key V. 

Sent by suspend key 

Sent by undo key 

Sent by shifted beg(inning) key 

Sent by shifted find key 

Sent by shifted cmd (command) key 

Sent by shifted copy key 

Sent by shifted create key 

Sent by shifted delete-char key 

Sent by shifted delete-line key 

Sent by select key 

Sent by shifted end key 

Sent by shifted clear-line key 

Sent by shifted exit key 

Printer won't echo on screen 

Sent by find key 

Sent by beg(inning) key 

Sent by cancel key 

Sent by close key 

Sent by cmd (command) key 

Sent by copy key 

Sent by create key 

Sent by end key 

Sent by enter/ send key (unreliable) 

Sent by exit key 

Graphic character set pairs aAbBcC - def-VTIOO | 
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%0 


str 


%1 


str 


%2 


str 


%3 


str 


%4 


str 


%5 


str 


%6 


str 


%7 


str 


%8 


str 


%9 


str 


%a 


str 


%b 


str 


%c 


str 


%d 


str 


%e 


str 


%f 


str 


%g 


str 


%h 


str 


%i 


str 


%i 


str 


&0 


str 


&1 


str 


&2 


str 


&3 


str 


&4 


str 


&5 


str 


&6 


str 


&7 


str 


&8 


str 


&9 


str 


*Q 


str 


*1 


str 


*2 


str 


*3 


str 


*4 


str 


*5 


str 


*6 


str 


*7 


str 


*8 


str 


*9 


str 


5i 


bool 


@o 


str 


@1 


str 


@2 


str 


@3 


str 


@4 


str 


@5 


str 


@6 


str 


@7 


str 


@8 


str 


@9 


str 


ac 


str 
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End alternate character set 

Add n new blank lines 

Add new blank line 

Terminal has automatic margins 

Start alternate character set 

Backspace if not ~H 

Audible signal (bell) 

Terminal can backspace with "H 

Back tab 

le (backspace) wraps from column to last column 

Clear to beginning of line, inclusive 

Terminal settable command character in prototype 

Clear to end of display 

Clear to end of line 

Set cursor column (horizontal position) 

Clear screen and home cursor 

Memory-relative cursor motion to row m , column n 

Screen-relative cursor motion to row m, column n 

Number of columns in a line 

Carriage return 

Change. scrolling region to lines m thru n (VT100) 

Clear all tab stops 

Set cursor row (vertical position) 

Display may be retained above the screen 

Milliseconds of bs delay needed (default 0) 

Display may be retained below the screen 

Delete n characters 

Milliseconds of cr delay needed (default 0) 

Delete character 

Milliseconds of ff delay needed (default 0) 

Delete n lines 

Delete line 

Enter delete mode 

Milliseconds of nl delay needed (default 0) 

Move cursor down n lines 

Down one line 

Disable status line 

Milliseconds of horizontal tab delay needed (default 0) 

Milliseconds of vertical tab delay needed (default 0) 

Enable graphic character set 

Erase n characters 

End delete mode 

End insert mode 

Can erase overstrikes with a blank 

Even parity 

Escape can be used on the status line 

Sent by function keys 11-19 

Sent by function keys 20-45 

Sent by function keys 46-63 

Hardcopy terminal page eject 

Return from status line 

Generic line type (e.g. dialup, switch) 
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ae 


str 


(p) 


AL 


str 


(NP*) 


al 


str 


(P*) 


am 


bool 




as 


str 


(P) 


be 


str 


(o) 


bl 


str 


(P) 


bs 


bool 


(o) 


bt 


str 


(P) 


bw 


bool 




cb 


str 


(P) 


CC 


str 




cd 


str 


(P*) 


ce 


str 


(P) 


ch 


str 


(NP) 


cl 


str 


(P.) 


CM 


str 


(NP) 


cm 


str 


(NP) 


CO 


num 




cr 


str 


(P*) 


cs 


str 


(NP) 


ct 


str 


(P) 


cv 


str 


(NP) 


da 


bool 




dB 


num 


(o) 


db 


bool 




DC 


str 


(NP*) 


dC 


num 


(o) 


dc 


str 


(P*) 


dF 


num 


(o) 


DL 


str 


(NP*) 


dl 


str 


(P.) 


dm 


str 




dN 


num 


<o) 


DO 


str 


(NP*) 


do 


str 




ds 


str 




dT 


num 


(o) 


dV 


num 


(o) 


eA 


str 


(P) 


ec 


str 


(NP) 


ed 


str 




ei 


str 




eo 


bool 




EP 


bool 


(o) 


es 


bool 




F1-F9 


str 




FA-FZstr 




Fa-Fr 


str 




ff 


str 


(P.) 


fs 


str 




gn 


bool 
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Cursor is hard to see 1 

Hardcopy terminal 

Half-duplex 

Half-line down (forward 1/2 linefeed) 

Home cursor 

Has extra "status line" 

Half-line up (reverse 1/2 linefeed) 

Cannot print ~s (Hazeltine) 

Initialize status line 

Terminal initialization strings (terminfo only) 

Insert n blank characters 

Insert character 

Name of file containing initialization string 

Enter insert mode 

Insert mode distinguishes nulls 

Pathname of program for initialization (terminfo only) 

Insert pad after character inserted 

Terminal initialization string 

Tabs initially every n positions 

Sent by function key 10 

Sent by keypad upper left 

Sent by keypad center 

Sent by keypad upper right 

Sent by keypad lower left 

Sent by keypad lower right 

Sent by function keys 0-9 £ 

Sent by insert-line key V 

Sent by clear-all-tabs key 

Sent by back-tab key 

Sent by backspace key 

Sent by clear-screen or erase key 

Sent by delete-character key 

Sent by down-arrow key 

Sent by clear-to-end-of-line key 

Out of "keypad transmit" mode 

Sent by scroll-forward/down key 

Sent by home-down key 

Sent by home key 

Sent by insert-character or enter-insert-mode key 

Sent by delete-line key 

Sent by left-arrow key 

Sent by insert key while in insert mode 

Has a "meta" key (shift, sets parity bit) 

Sent by next-page key 

Number of function (k0-k9) keys (default 0) 

termcap entries for other non-function keys 

Sent by previous-page key 

Sent by scroll-backward/up key 

Sent by right-arrow key 

Sent by clear-to-end-of -screen key 

Put terminal in "keypad transmit" mode ^ 

Sent by set-tab key § 
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HC 


bool 




he 


bool 




HD 


bool 


(o) 


hd 


str 




ho 


str 


(P) 


hs 


bool 




hu 


str 




hz 


bool 




i2 






il,i3 


str 




IC 


str 


(NP*) 


ic 


str 


(P*) 


if 


str 




im 


str 




in 


bool 




iP 


str 




ip 


str 


(P*> 


is 


str 




it 


num 




k; 


str 




Kl 


str. 




K2 


str 




K3 


str 




K4 


str 




K5 


str 




k0-k9 


str 




kA 


str 




ka 


str 




kB 


str 




kb 


str 




kC 


str 




kD 


str 




kd 


str 




kE 


str 




ke 


str 




kF 


str 




kH 


str 




kh 


str 




kl 


str 




kL 


str 




kl 


str 




kM 


str 




km 


bool 




kN 


str 




kn 


num 


(o) 


ko 


str 


(o) 


kP 


str 




kR 


str 




kr 


str 




kS 


str 




ks 


str 




kT 


str 
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kt 


str 




ku 


str 




la 


str 




10-19 


str 




LC 


bool 


(o) 


LE 


str 


(NP) 


le 


str 


(P) 


LF 


str 


(P) 


lh 


num 




li 


num 




11 


str 




lm 


num 




LO 


str 


(P) 


lw 


num 




ma 


str 


(o) 


mb 


str 




MC 


str 


(P) 


md 


str 




me 


str 




mh 


str 




mi 


bool 




mk 


str 




ML 


str 


(P) 


ml 


str 


(o) 


mm 


str 




mo 


str 




mp 


str 




MR 


str 


(P) 


mr 


str 




ms 


bool 




mu 


str 


(o) 


nc 


bool 


(o) 


nd 


str 




NL 


bool 


(o) 


Nl 


num 




nl 


str 


(o) 


NP 


bool 




NR 


bool 




ns 


bool 


(o) 


nw 


str 


(P) 


nx 


bool 




OP 


bool 


(o) 


OS 


bool 




P b 


num 




pc 


str 




pf 


str 




pk 


str 




pi 


str 




pn 


str 


(NP) 


po 


str 


(N) 


po 


str 




ps 


str 





Sent by clear-tab key 

Sent by up-arrow key 

Label on function key 10 if not flO 

Labels on function keys 0-9 if not f0-f9 

Lower-case only 

Move cursor left n positions 

Move cursor left one position 

Turn off soft labels 

Number of rows in each label 

Number of lines on screen or page 

Last line, first column 

Lines of memory if > li (0 means varies) 

Turn on soft labels 

Number of columns in each label 

Arrow key map (used by vi version 2 only) 

Turn on blinking attribute 

Clear left and right soft margins 

Turn on bold (extra bright) attribute 

Turn off all attributes 

Turn on half-bright attribute 

Safe to move while in insert mode 

Turn on blank attribute (characters invisible) 

Set soft left margin 

Memory lock on above cursor 

Turn on "meta mode" (8th bit) 

Turn off "meta mode" 

Turn on protected attribute 

Set soft right margin 

Turn on reverse-video attibute 

Safe to move in standout modes 

Memory unlock (turn off memory lock) 

No correctly-working cr (Datamedia 2500, Hazeltine 2000) 

Non-destructive space (cursor right) 

\n is newline, not line feed 

Number of labels on screen (start at 1) 

Newline character if not \n 

Pad character doesn't exist 

ti does not reverse te 

Terminal is a CRT but doesn't scroll 

Newline (behaves like cr followed by do) 

Padding won't work, xoff/xon required 

Odd parity 

Terminal overstrikes 

Lowest baud where delays are required 

Pad character (default NUL) 

Turn off the printer 

Program function key n to type string s {terminfo only) 

Program function key n to execute string $ {terminfo only) 

Program label n to show string s {terminfo only) 

Turn on the printer for n bytes 

Turn on the printer 

Print contents of the screen 
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Has hardware tabs (may need to be set with is) I 

Program function key n to transmit string s {terminfo only) ^ 

Reset terminal completely to sane modes {terminfo only) 

Turn off automatic margins 

Restore cursor to position of last sc 

Send next input character (for ptys) 

Name of file containing reset string 

Move'cursor right n positions 

Like ip but when in replace mode 

Repeat character c n times 

Reset terminal completely to sane modes 

Turn off xoff/xon handshaking 

Turn on automatic margins 

Define the video attributes (9 parameters) 

Save cursor position 

End standout mode 

Scroll forward n lines 

Scroll text up 

Number of garbage chars left by so or se (default 0) 

Begin standout mode 

Scroll backward n lines 

Scroll text down 

Set a tab in all rows, current column 

Turn on xoff/xon handshaking 

Tab to next 8-position hardware tab stop 

Entry of similar terminal - must be last £ 

String to end programs that use termcap \ 

String to begin programs that use termcap 

Go to status line 5 column n 

Upper-case only 

Underscore one character and move past it 

End underscore mode 

Number of garbage chars left by us or ue (default 0) 

Underline character overstrikes 

Move cursor up n lines 

Upline (cursor up) 

Start underscore mode 

Visible bell (must not move cursor) 

Make cursor appear normal (undo vs/vi) 

Make cursor invisible 

Make cursor very visible 

Virtual terminal number (not supported on all systems) 

Set current window to lines i thru /, columns m thru n 

Number of columns in status line 

Beehive (fl=ESC, f2="Q 

X-off character (default DC3) 

X-on character (default do) 

Newline ignored after 80 cols (Concept) 

Terminal uses xoff/xon handshaking 

Return acts like ce cr nl (Delta Data) 

Standout not erased by overwriting (Hewlett-Packard) 

Tabs destructive, magic so char (Teleray 1061) £ 
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pt 


bool 


(o) 


px 


str 




rl,r3 


str 




RA 


Str 


(P) 


re 


str 


(P) 


RF 


str 




rf 


str 




RI 


str 


(NP) 


rP 


str 


(P) 


rp 


str 


(NP*) 


rs 


str 




RX 


str 


(P) 


SA 


str 


(P) 


sa 


str 


(NP) 


sc 


str 


(P) 


se 


str 




SF 


str 


(NP*) 


rf 


str 


(P) 


sg 


num 




so 


str 




SR 


str 


(NP*) 


sr 


str 


(P) 


st 


str 




sx 


str 


(P) 


ta 


str 


(P) 


tc 


str 




te 


str 




ti 


str 




ts 


str 


(N) 


UC 


bool 


(o) 


uc 


str 




ue 


str 




ug 


num 




ul 


bool 




UP 


str 


(NP*) 


up 


str 




us 


str 




vb 


str 




ve 


str 




vi 


str 




vs 


str 




vt 


num 




wi 


str 


(N) 


ws 


num 




xb 


bool 




XF 


str 




XN 


str 




xn 


bool 




xo 


bool 




xr 


bool 


(o) 


xs 


bool 




xt 


bool 





TERMCAP ( 5-BSD ) RISC/os Programmer's Reference TERMCAP ( 5-BSD ) 



xx bool (o) Tektronix 4025 insert-line 

A Sample Entry 

The following entry, which describes the Concept-100, is among the more complex entries in 
the termcap file as of this writing. 

ca | conceptlOO | clOO | concept | cl04 | conceptl00-4p | HDS Concept-100:\ 

:al=3*\E A R:am:bl== /> G:cd=16*\E^C:ce==16\E A U:cl=2* A L:cm=\Ea%+ %+ :\ 

:co#80:xr=9 A M:db:dc=16\E A A:dl=3AE A B;do= A J:ei=\E\200:eo:im=\E A P:in:\ 

:ip=16*:is=\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\Eo&\200\Eo\47\E:kl=\E5:\ 

;k2=\E6:k3=\E7:kb- A h:kd=\E<:ke=\Ex:kh=\E?:kl=\E>:kr=\E=:ks=\EX:\ 

:ku=\E;:le= A H:li#24:mb=\EC:me=\EN\200:mh=\EE:mi:mk=\EH:mp=\EI:\ 

:mr=\ED:nd=\E=:pb#9600:rp=0.2*\Er% .%+ :se=\Ed\Ee:sf= A J:so=\EE\ED:\ 

: .ta=8\t:te=\Ev \200\200\200\200\200\200\Ep\r\n:\ 

:ti=\EU\Ev 8p\Ep\r:ue=\Eg:ul:up=\E;:us=\EG:\ 

:vb=\Ek\200\200\200\200\200\2(X)\200\200\200\200^^ 

:ve=\Ew:vs=\EW:vt#8:xn:\ 

:bs:cr= A M:dC#9:dT#8:nl= A J:ta= A I:pt: 

Entries may continue onto multiple lines by giving a \ as the last character of a line, and 
empty fields may be included for readability (here between the last field on a line and the first 
field on the next). Comments may be included on lines beginning with "#". 

Types of Capabilities 

Capabilities in termcap are of three types: Boolean capabilities, which indicate particular 
features that the terminal has; numeric capabilities, giving the size of the display or the size of 
other attributes; and string capabilities, which give character sequences that can be used to 
perform particular terminal operations. All capabilities have two-letter codes. For instance, 
the fact that the Concept has automatic margins (i.e., an automatic return and linefeed when 
the end of a line is reached) is indicated by the Boolean capability am. Hence the description 
of the Concept includes am. 

Numeric capabilities are followed by the character '#' then the value. In the example above 
co, which indicates the number of columns the display has, gives the value '80' for the Con- 
cept. 

Finally, string-valued capabilities, such as ce (clear-to~end-of-line sequence) are given by the 
two-letter code, an '=', then a string ending at the next following *:\ A delay in milliseconds 
may appear after the '=' in such a capability, which causes padding characters to be supplied 
by tputs after the remainder of the string is sent to provide this delay. The delay can be either 
a number, e.g. '20', or a number followed by an V, i.e., '3*\ An V indicates that the pad- 
ding required is proportional to the number of lines affected by the operation, and the amount 
given is the per-affected-line padding required. (In the case of insert-character, the factor is 
still the number of lines affected; this is always 1 unless the terminal has in and the software 
uses it.) When an V is specified, it is sometimes useful to give a delay of the form '3.5' to 
specify a delay per line to tenths of milliseconds. (Only one decimal place is allowed.) 

A number of escape sequences are provided in the string-valued capabilities for easy encoding 
of control characters there. \E maps to an esc character, *X maps to a control-X for any 
appropriate X, and the sequences \n \r \t \b \f map to linefeed, return, tab, backspace, and 
formfeed, respectively. Finally, characters may be given as three octal digits after a \, and the 
characters * and \ may be given as \" and \\. If it is necessary to place a : in a capability it 
must be escaped in octal as \072. If it is necessary to place a NUL character in a string capa- 
bility it must be encoded as \200. (The routines that deal with termcap use C strings and strip 
the high bits of the output very late, so that a \200 comes out as a \000 would.) 
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Sometimes individual capabilities must be commented out. To do this, put a period before | 

the capability name. For example, see the first qr and ta in the example above. 

Preparing Descriptions 

We now outline how to prepare descriptions of terminals. The most effective way to prepare 
a terminal description is by imitating the description of a similar terminal in termcap and to 
build up a description gradually, using partial descriptions with vi to check that they are 
correct. Be aware that a very unusual terminal may expose deficiencies in the ability of the 
termcap file to describe it or bugs in vi , To easily test a new terminal description you can set 
the environment variable TERMCAP to the absolute pathname of a file containing the descrip- 
tion you are working on and programs will look there rather than in I etcl termcap . TERMCAP 
can also be set to the termcap entry itself to avoid reading the file when starting up a program. 

To get the padding for insert-line right (if the terminal manufacturer did not document it), a 
severe test is to use vi to edit Jetc/passwd at 9600 baud, delete roughly 16 lines from the mid- 
dle of the screen, then hit the 4 u ? key several times quickly. If the display messes up, more 
padding is usually needed. A similar test can be used for insert-character. 

Basic Capabilities 

The number of columns on each line of the display is given by the co numeric capability. If 
the display is a CRT, then the number of lines on the screen is given by the li capability. If 
the display wraps around to the beginning of the next line when the cursor reaches the right 
margin, then it should have the am capability. If the terminal can clear its screen, the code to 
do this is given by the cl string capability. If the terminal overstrikes (rather than clearing the 
position when a character is overwritten), it should have the os capability. If the terminal is a 
printing terminal, with no soft copy unit, give it both he and os. (os applies to storage scope 
terminals, such as the Tektronix 4010 series, as well as to hard copy and APL terminals,) If 
there is a code to move the cursor to the left edge of the current row, give this as cr. (Nor- 
mally this will be carriage-return, *M,) If there is a code to produce an audible signal (bell, 
beep, etc, ), give this as bl. 

If there is a code (such as backspace) to move the cursor one position to the left, that capabil- 
ity should be given as le. Similarly, codes to move to the right, up, and down should be given 
as nd, up, and do, respectively, These local cursor motions should not alter the text they pass 
over; for example, you would not normally use "nd= " unless the terminal has the os capabil- 
ity, because the space would erase the character moved over. 

A very important point here is that the local cursor motions encoded in termcap have 
undefined behavior at the left and top edges of a CRT display. Programs should never attempt 
to backspace around the left edge, unless bw is given, and never attempt to go up off the top 
using local cursor motions. 

In order to scroll text up, a program goes to the bottom left corner of the screen and sends 
the sf (index) string. To scroll text down ? a program goes to the top left corner of the screen 
and sends the sr (reverse index) string, The strings sf and sr have undefined behavior when 
not on their respective corners of the screen. Parameterized versions of the scrolling 
sequences are SF and SR, which have the same semantics as sf and sr except that they take 
one parameter and scroll that many lines. They also have undefined behavior except at the 
appropriate corner of the screen. 

The am capability tells whether the cursor sticks at the right edge of the screen when text is 
output there, but this does not necessarily apply to nd from the last column. Leftward local 
motion is defined from the left edge only when bw is given; then an le from the left edge will 
move to the right edge of the previous row. This is useful for drawing a box around the edge 
of the screen, for example. If the terminal has switch-selectable automatic margins, the 
termcap description usually assumes that this feature is on, i.e., am. If the terminal has a 
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command that moves to the first column of the next line, that command can be given as nw 
(newline). It is permissible for this to clear the remainder of the current line, so if the termi- 
nal has no correctly-working CR and LF it may still be possible to craft a working nw out of 
one or both of them. 

These capabilities suffice to describe hardcopy and "glass-tty" terminals. Thus the Teletype 
model 33 is described as 

T3 |tty33 1 33 |tty | Teletype model 33 :\ 

:bl= /v G:co#72:cr= /v M:do= A J:hc:os: 

and the Lear Siegler ADM-3 is described as 

13|adm3|3|LSlADM-3:\ 

:am:bl= /s G:cl^Z:co#80:cr= A M:do^J:le^H:li#24:sf=^J: 

Parameterized Strings 

Cursor addressing and other strings requiring parameters are described by a parameterized 
string capability, with printf (3S)-like escapes %x in it, while other characters are passed 
through unchanged. For example, to address the cursor the cm capability is given, using two 
parameters: the row and column to move to. (Rows and columns are numbered from zero 
and refer to the physical screen visible to the user, not to any unseen memory. If the terminal 
has memory-relative cursor addressing, that can be indicated by an analogous CM capability.) 

The % encodings have the following meanings: 

%% output '%> 

%d output value as in printf %d 

%2 output value as in printf %2d 

%3 output value as in printf %3d 

% . output value as in printf %c 

%+# add x to value, then do %. 

% >xy if value > x then add y , no output 

%r reverse order of two parameters, no output 

%i increment by one, no output 

%n exclusive-or all parameters with 0140 (Datamedia 2500) 

%B BCD (16*(value/10)) + (value%10), no output 

%D Reverse coding (value - 2*(value%16)), no output (Delta Data) 

Consider the Hewlett-Packard 2645, which, to get to row 3 and column 12, needs to be sent 
"\E&al2c03Y" padded for 6 milliseconds. Note that the order of the row and column coordi- 
nates is reversed here and that the row and column are sent as two-digit integers. Thus its cm 
capability is "cm=6\E&%r%2c%2Y". 

The Microterm ACT-IV needs the current row and column sent simply encoded in binary pre- 
ceded by a "T, u cm="T%.%.". Terminals that use "%." need to be able to backspace the 
cursor (le) and to move the cursor up one line on the screen (up). This is necessary because 
it is not always safe to transmit \n, ~D, and \r, as the system may change or discard them. 
(Programs using termcap must set terminal modes so that tabs are not expanded, so \t is safe 
to send. This turns out to be essential for the Ann Arbor 4080.) 

A final example is the Lear Siegler ADM-3a, which offsets row and column by a blank charac- 
ter, thus "cm=\E=%+ %+ ". 

Row or column absolute cursor addressing can be given as single parameter capabilities ch 
(horizontal position absolute) and cv (vertical position absolute). Sometimes these are shorter 
than the more general two-parameter sequence (as with the Hewlett-Packard 2645) and can be 
used in preference to cm. If there are parameterized local motions {e.g. , move n positions to 
the right) these can be given as DO, LE, RI, and UP with a single parameter indicating how 
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many positions to move. These are primarily useful if the terminal does not have cm, such as I 

the Tektronix 4025. V 

Cursor Motions 

If the terminal has a fast way to home the cursor (to the very upper left corner of the screen), 
this can be given as ho. Similarly, a fast way of getting to the lower left-hand corner can be 
given as 11; this may involve going up with up from the home position, but a program should 
never do this itself (unless 11 does), because it can make no assumption about ihe effect of 
moving up from the home position. Note that the home position is the same as cursor 
address (0,0): to the top left corner of the screen, not of memory. (Therefore, the "\EH" 
sequence on Hewlett-Packard terminals cannot be used for ho.) 

Area Clears 

If the terminal can clear from the current position to the end of the line, leaving the cursor 
where it is, this should be given as ce. If the terminal can clear from the current position to 
the end of the display, this should be given as cd. cd must only be invoked from the first 
column of a line. (Therefore, it can be simulated by a request to delete a large number of 
lines, if a true cd is not available.) 

Insert/Delete Line 

If the terminal can open a new blank line before the line containing the cursor, this should be 
given as al; this must be invoked only from the first position of a line. The cursor must then 
appear at the left of the newly blank line. If the terminal can delete the line that the cursor is 
on, this should be given as dl; this must only be used from the first position on the line to be 
deleted. Versions of al and dl which take a single parameter and insert or delete that many 
lines can be given as AL and DL. If the terminal has a settable scrolling region (like the 
VT100), the command to set this can be described with the cs capability, which takes two 
parameters: the top and bottom lines of the scrolling region. The cursor position is, alas, 
undefined after using this command. It is possible to get the effect of insert or delete line 
using this command - the sc and re (save and restore cursor) commands are also useful. 
Inserting lines at the top or bottom of the screen can also be done using sr or sf on many ter- 
minals without a true insert/delete line, and is often faster even on terminals with those 
features. 

H the terminal has the ability to define a window as part of memory which all commands 
affect, it should be given as the parameterized string wi. The four parameter^ are the starting 
and ending lines in memory and the starting and ending columns in memory, in that order, 
(This terminfo capability is described for completeness. It is unlikely that any termcap -using 
program will support it.) 

If the terminal can retain display memory above the screen, then the da capability should be 
given; if display memory can be retained below, then dfo should be given. These indicate that 
deleting a line or scrolling may bring non-blank lines up from below or that scrolling back with 
sr may bring down non-blank lines. 

Insert/Delete Character 

There are two basic kinds of intelligent terminals with respect to insert/delete character that 
can be described using termcap . The most common insert/delete character operations affect 
only the characters on the current line and shift characters off the end of the line rigidly. 
Other terminals, such as the Concept- 100 and the Perkin Elmer Owl, make a distinction 
between typed and untyped blanks on the screen, shifting upon an insert or delete only to an 
untyped blank on the screen which is either eliminated or expanded to two untyped blanks. 
You can determine the kind of terminal you have by clearing the screen then typing text 
separated by cursor motions. Type "abc def using local cursor motions (not spaces) 
between the "abc" and the "def \ Then position the cursor before the "abc" and put the 
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terminal in insert mode. If typing characters causes the rest of the line to shift rigidly and 
characters to fall off the end, then your terminal does not distinguish between blanks and 
untyped positions. If the "abc" shifts over to the M def ' which then move together around the 
end of the current line and onto the next as you insert, then you have the second type of ter- 
minal and should give the capability in, which stands for "insert null". While these are two 
logically separate attributes (one line vs. multiline insert mode, and special treatment of 
untyped spaces), we have seen no terminals whose insert mode cannot be described with the 
single attribute. 

termcap can describe both terminals that have an insert mode and terminals that send a simple 
sequence to open a blank position on the current line. Give as im the sequence to get into 
insert mode. Give as ei the sequence to leave insert mode. Now give as ic any sequence that 
needs to be sent just before each character to be inserted. Most terminals with a true insert 
mode will not give ic; terminals that use a sequence to open a screen position should give it 
here. (If your terminal has both, insert mode is usually preferable to ic. Do not give both 
unless the terminal actually requires both to be used in combination.) If post-insert padding is 
needed, give this as a number of milliseconds in ip (a string option). Any other sequence that 
may need to be sent after insertion of a single character can also be given in ip. If your termi- 
nal needs to be placed into an 'insert mode' and needs a special code preceding each inserted 
character, then both im/ei and ic can be given, and both will be used. The IC capability, with 
one parameter n , will repeat the effects of ic n times. 

It is occasionally necessary to move around while in insert mode to delete characters on the 
same line (e.g., if there is a tab after the insertion position). If your terminal allows motion 
while in insert mode, you can give the capability mi to speed up inserting in this case. Omit- 
ting mi will affect only speed. Some terminals (notably Datamedia's) must not have mi 
because of the way their insert mode works. 

Finally, you can specify dc to delete a single character, DC with one parameter n to delete n 
characters, and delete mode by giving dm and «d to enter and exit delete mode (which is any 
mode the terminal needs to be placed in for dc to work). 

Highlighting, Underlining, and Visible BeUs 

If your terminal has one or more kinds of display attributes, these can be represented in a 
number of different ways. You should choose one display form as standout mode, represent- 
ing a good high-contrast, easy-op-the-eyes format for highlighting error messages and other 
attention getters. (If you have a choice, reverse video plus half-bright is good, or reverse 
video alone.) The sequences to enter and exit standout mode are given as so and se, respec- 
tively. If the code to change into or out of standout mode leaves one or even two blank 
spaces or garbage characters on the screen, as the TVT 912 and Teleray 1061 do, then sg 
should be given to tell how many characters are left, 

Codes to begin underlining and end underlining can be given as us and ue, respectively. 
Underline mode change garbage is specified by ug, similar to sg. If the terminal has a code to 
underline the current character and move th^ cursor one position to the right, such as the 
Microterm Mime, this can be given as uc. 

Other capabilities to enter various highlighting modes include mb (blinking), md (bold or extra 
bright), mh (dim or half-bright), mk (blanking or invisible text), mp (protected), mr (reverse 
video), me (turn off all attribute modes), as (enter alternate character set mode), and ae (exit 
alternate character set mode). Turning on any of these modes singly may or may not turn off 
other modes. 

If there is a sequence to set arbitrary combinations of mode, this should be given as sa (set 
attributes), taking 9 parameters. Each parameter is either or 1, as the corresponding attri- 
butes is on or off. The 9 parameters are, in order: standout, underline, reverse, blink, dim, 
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bold, blank, protect, and alternate character set. Not all modes need be supported by sa, I 

only those for which corresponding attribute commands exist. (It is unlikely that a termcap- ^ 

using program will support this capability, which is defined for compatibility with terminfo .) 

Terminals with the "magic cookie" glitches (sg and ug), rather than maintaining extra attri- 
bute bits for each character cell, instead deposit special "cookies", or "garbage characters", 
when they receive mode-setting sequences, which affect the display algorithm. 

Some terminals, such as the Hewlett-Packard 2621, automatically leave standout mode when 
they move to a new line or when the cursor is addressed. Programs using standout mode 
should exit standout mode on such terminals before moving the cursor or sending a newline. 
On terminals where this is not a problem, the ms capability should be present to say that this 
overhead is unnecessary. 

If the terminal has a way of flashing the screen to indicate an error quietly (a bell replace- 
ment), this can be given as vb; it must not move the cursor. 

If the cursor needs to be made more visible than normal when it is not on the bottom line (to 
change, for example, a non-blinking underline into an easier-to-find block or blinking under- 
line), give this sequence as vs. If there is a way to make the cursor completely invisible, give 
that as vi. The capability ve, which undoes the effects of both of these modes, should also be 
given. 

If your terminal correctly displays underlined characters (with no special codes needed) even 
though it does not overstrike, then you should give the capability ul. If overstrikes are eras- 
able with a blank, this should be indicated by giving eo. 

Keypad 

If the terminal has a keypad that transmits codes when the keys are pressed, this information g- 

can be given. Note that it is not possible to handle terminals where the keypad only works in f 

local mode (this applies, for example, to the unshifted Hewlett-Packard 2621 keys). If the 
keypad can be set to transmit or not transmit, give these codes as ks and ke. Otherwise the 
keypad is assumed to always transmit. The codes sent by the left-arrow, right-arrow, up- 
arrow, down-arrow, and home keys can be given as kl, kr, ku, kd, and kh, respectively. If 
there are function keys such as fO, fl, ..,, f9, the codes they send can be given as kO, kl, k9. 
If these keys have labels other than the default fO through f9, the labels can be given as 10, 11, 
19. The codes transmitted by certain other special keys can be given: kH (home down), kb 
(backspace), ka (clear all tabs), kt (clear the tab stop in this column), kC (clear screen or 
erase), kD (delete character), kL (delete line), kM (exit insert mode), kE (clear to end of 
line), kS (clear to end of screen), kl (insert character or enter insert mode), kA (insert line), 
kN (next page), kP (previous page), kF (scroll forward/down), kR (scroll backward/up), and 
kT (set a tab stop in this column). In addition, if the keypad has a 3 by 3 array of keys includ- 
ing the four arrow keys, then the other five keys can be given as Kl, K2, K3, K4, and K5. 
These keys are useful when the effects of a 3 by 3 directional pad are needed. The obsolete 
ko capability formerly used to describe "other" function keys has been completely supplanted 
by the above capabilities. 

The ma entry is also used to indicate arrow keys on terminals that have single-character arrow 
keys. It is obsolete but still in use in version 2 of vi which must be run on some minicomput- 
ers due to memory limitations. This field is redundant with kl, kr, ku, kd, and kh. It consists 
of groups of two characters. In each group, the first character is what an arrow key sends, 
and the second character is the corresponding vi command. These commands are h for kl, j 
for kd, E for ku, 1 for kr, and H for kh. For example, the Mime would have 
'W-lih^KfZk^XT indicating arrow keys left fH), down (K), up fZ), and right fX). 
(There is no home key on the Mime.) 



c 
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Tabs and Initialization 

If the terminal needs to be in a special mode when running a program that uses these capabili- 
ties, the codes to enter and exit this mode can be given as ti and te. This arises, for example, 
from terminals like the Concept with more than one page of memory. If the terminal has only 
memory-relative cursor addressing and not screen-relative cursor addressing, a screen-sized 
window must be fixed into the display for cursor addressing to work properly. This is also 
used for the Tektronix 4025, where ti sets the command character to be the one used by 
termcap . 

Other capabilities include is, an initialization string for the terminal, and if, the name of a file 
containing long initialization strings. These strings are expected to set the terminal into modes 
consistent with the rest of the termcap description, They are normally sent to the terminal by 
the tset program each time the user logs in. They will be printed in the following order: is; 
setting tabs using ct and st; and finally if. (Terminfo uses il before is and runs the program iP 
and prints i3 after the other initializations.) A pair of sequences that does a harder reset from 
a totally unknown state can be analogously given as rs and if. These strings are output by the 
reset program, which is used when the terminal gets into a wedged state. {Terminfo uses rl 
before rs and r3 after.) Commands are normally placed in rs and if only if they produce 
annoying effects on the screen and are not necessary when logging in. For example, the com- 
mand to set the VT100 into 80-column mode would normally be part of is, but it causes an 
annoying glitch of the screen and is not normally needed since the terminal is usually already 
in 80-column mode. *" . 

If the terminal has hardware tabs, the command to advance to the next tab stop can be given 
as ta (usually *I). A "backtab" command which moves leftward to the previous tab stop can 
be given as bt. By convention, if the terminal driver modes indicate that tab stops are being 
expanded by the computer rather than being sent to the terminal, programs should not use ta 
or bt even if they are present, since the user may not have the tab stops properly set. If the 
terminal has hardware tabs that are initially set every n positions when the terminal is powered 
up, then the numeric parameter it is given, showing the number of positions between tab 
stops. This is normally used by the tset command to determine whether to set the driver 
mode for hardware tab expansion, and whether to set the tab stops. If the terminal has tab 
stops that can be saved in nonvolatile memory, the termcap description can assume that they 
are properly set. 

If there are commands to set and clear tab stops, they can be given as ct (clear all tab stops) 
and st (set a tab stop in the current column of every row). If a more complex sequence is 
needed to set the tabs than can be described by this, the sequence can be placed in is or if. 

Delays 

Certain capabilities control padding in the terminal driver. These are primarily needed by 
hardcopy terminals and are used by the tset program to set terminal driver modes appropri- 
ately. Delays embedded in the capabilities cr, sf, le, ff, and ta will cause the appropriate 
delay bits to be set in the terminal driver. If pb (padding baud rate) is given, these values can 
be ignored at baud rates below the value of pb. For 4.2BSD tset, the delays are given as 
numeric capabilities dC, dN, dB, dF, and dT instead. 

Miscellaneous 

If the terminal requires other than a nul (zero) character as a pad, this can be given as pc. 
Only the first character of the pc string is used. 

If the terminal has commands to save and restore the position of the cursor, give them as sc 
and rc f 
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If the terminal has an extra "status line" that is not normally used by software, this fact can be | 

indicated. If the status line is viewed as an extra line below the bottom line, then the capabil- ^ 

ity hs should be given. Special strings to go to a position in the status line and to return from 
the status line can be given as ts and fs. (fs must leave the cursor position in the same place 
that it was before ts. If necessary, the sc and re strings can be included in ts and fs to get this 
effect.) The capability ts takes one parameter, which is the column number of the status line 
to which the cursor is to be moved. If escape sequences and other special commands such as 
tab work while in the status line, the flag es can be given. A string that turns off the status 
line (or otherwise erases its contents) should be given as ds. The status line is normally 
assumed to be the same width as the rest of the screen, i.e., co. If the status line is a 
different width (possibly because the terminal does not allow an entire line to be loaded), then 
its width in columns can be indicated with the numeric parameter ws. 

If the terminal can move up or down half a line, this can be indicated with hu (half-line up) 
and hd (half-line down). This is primarily useful for superscripts and subscripts on hardcopy 
terminals. If a hardcopy terminal can eject to the next page (form feed), give this as ff (usu- 
ally 1L). 

If there is a command to repeat a given character a given number of times (to save time 
transmitting a large number of identical characters), this can be indicated with the parameter- 
ized string rp. The first parameter is the character to. be repeated and the second is the 
number of times to repeat it. (This is a terminfo feature that is unlikely to be supported by a 
program that uses terrncap .) 

K the terminal has a settable command character, such as the Tektronix 4025, this can be 
indicated with CC. A prototype command character is chosen which is used in all capabili- 
ties. This character is given in the CC capability to identify it. The following convention is 
supported on some UNIX systems: The environment is to be searched for a CC variable, and 
if found, all occurrences of the prototype character are replaced by the character in the 
environment variable. This use of the CC environment variable is a very bad idea, as it 
conflicts with make(l). 

Terminal descriptions that do not represent a specific kind of known terminal, such as switch , 
dialup, patch, and network, should include the gn (generic) capability so that programs can 
complain that they do not know how to talk to the terminal. (This capability does not apply 
to virtual terminal descriptions for which the escape sequences are known.) 

If the terminal uses xoff/xon (dcs/dci) handshaking for flow control, give xo. Padding infor- 
mation should still be included so that routines can make better decisions about costs, but 
actual pad characters will not be transmitted. 

If the terminal has a "meta key" which acts as a shift key, setting the 8th bit of any character 
transmitted, then this fact can be indicated with km. Otherwise, software will assume that the 
8th bit is parity and it will usually be cleared. If strings exist to turn this "meta mode" on and 
off, they can be given as mm and mo. 

If the terminal has more lines of memory than will fit on the screen at once, the number of 
lines of memory can be indicated with lm. An explicit value of indicates that the number of 
lines is not fixed, but that there is still more memory than fits on the screen. 

If the terminal is one of those supported by the UNIX system virtual terminal protocol, the 
terminal number can be given as vt. 

Media copy strings which control an auxiliary printer connected to the terminal can be given 
as ps: print the contents of the screen; p£: turn off the printer; and po: turn on the printer. 
When the printer is on, all text sent to the terminal will be sent to the printer. It is undefined 
whether the text is also displayed on the terminal screen when the printer is on. A variation ^ 

pO takes one parameter and leaves the printer on for as many characters as the value of the I 
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parameter, then turns the printer off. The parameter should not exceed 255. All text, includ- 
ing pf, is transparently passed to the printer while pO is in effect. 

Strings to program function keys can be given as pk, pi, and px. Each of these strings takes 
two parameters: the function key number to program (from to 9) and the string to program 
it with. Function key numbers out of this range may program undefined keys in a terminal- 
dependent manner. The differences among the capabilities are that pk causes pressing the 
given key to be the same as the user typing the given string; pi causes the string to be executed 
by the terminal in local mode; and px causes the string to be transmitted to the computer. 
Unfortunately, due to lack of a definition for string parameters in termcap , only terminfo sup- 
ports these capabilities. 

Glitches and Braindamage 

Hazeltine terminals, which do not allow '~' characters to be displayed, should indicate hz. 

The nc capability, now obsolete, formerly indicated Datamedia terminals, which echo \r \n 
for carriage return then ignore a following linefeed. 

Terminals that ignore a linefeed immediately after an am wrap, such as the Concept, should 
indicate xn. 

If ce is required to get rid of standout (instead of merely writing normal text on top of it), xs 
should be given. 

Teleray terminal* wher tabs turn all characters moved over to blanks, should indicate xt 
(destructive tabs). This glitch is also taken to mean that it is not possible to position the cur- 
sor on top of a "magic cookie", and that to erase standout mode it is necessary to use delete 
and insert line. 

The Beehive Superbee, which is unable to correctly transmit the esc or "C characters, has xb, 
indicating that the "fl" key is used for esc and "f2" for C. (Only certain Superbees have this 
problem, depending on the ROM.) 

Other specific terminal problems may be corrected by adding more capabilities of the form xx. 

Similar Terminals 

If there are two very similar terminals, one can be defined as being just like the other with cer- 
tain exceptions. The string capability tc can be given with the name of the similar terminal. 
This capability must be last , and the combined length of the entries must not exceed 1024. 
The capabilities given before tc override those in the terminal type invoked by tc. A capabil- 
ity can be canceled by placing xx@ to the left of the tc invocation, where xx is the capability. 
For example, the entry 

hn |2621-nl:ks@:ke@:tc=2621: 

defines a "2621-nl" that does not have the ks or ke capabilities, hence does not turn on the 
function key labels when in visual mode. This is useful for different modes for a terminal, or 
for different user preferences. 

AUTHOR 

William Joy 

Mark Horton added underlining and keypad support 

FILES 

/etc/ termcap file containing terminal descriptions 

SEE ALSO 

ex(l), tset(l), vi(l), curses(3X), printf(3S), term(5). 
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CAVEATS AND BUGS 

Note: termcap was replaced by terminfo in UNIX System V Release 2.0. The transition will 
be relatively painless if capabilities flagged as "obsolete" are avoided. 

Vi allows only 256 characters for string capabilities, and the routines in termlib(3) do not 
check for overflow of this buffer. The total length of a single entry (excluding only escaped 
newlines) may not exceed 1024. 

Not all programs support all entries. 
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